mrkeyoor.com_
Tue 01 Sept 17:45 UTC
Webevaluationupdated 26 Aug 2026

youtube-music review

This repository presents a portable Windows client for streaming YouTube Music without ads or a premium subscription. Its README promises search, background playback, media keys, a dark theme, and playlists stored on the user's machine, but the package metadata identifies the code as Pear Desktop and points to a different repository.

-37stars / 7d
Verdict

Our checkout built in 12 seconds and passed 5 of 6 tests, but its package metadata names Pear Desktop and points to pear-devs/pear-desktop rather than this project. That identity mismatch is enough to withhold a recommendation for the password-protected Windows executable until the maintainer documents the relationship and release build process. Users who simply want a desktop YouTube Music wrapper have older alternatives with clearer provenance.

We ran it

Lab card: what happened when we ran youtube-musicScreenshot of youtube-music (github.com/sohaibdevv/youtube-music)
Install✓ · 35s776 packages · 959 MB
Build✓ · 12s
Tests✗ · 22sran, no count parsed
Repo412 files~33,598 lines of source · 6.4 MB · 7 CI workflows · tests dir

Answers from our run

Does youtube-music build from source?

Dependencies installed in 35 seconds (776 packages), and the build succeeded in 12 seconds. We cloned commit 1a7c978 into a clean Debian container with 3 CPUs and no project-specific setup.

Do youtube-music's tests pass?

The test command failed in our container, and its output did not report a pass or fail count.

Who should not use youtube-music?

Anyone unwilling to run a password-protected ZIP from a new publisher: the README distributes one EXE inside an archive protected with ytm4all.

What are the alternatives to youtube-music?

YouTube Music Desktop, Pear Desktop. Our checkout built in 12 seconds and passed 5 of 6 tests, but its package metadata names Pear Desktop and points to pear-devs/pear-desktop rather than this project.

Setup3/512-second build; one launch test failed in Debian
Docs2/5Simple user steps omit source provenance and build explanation
Community2/5836 stars, no open issues or PRs, and one public release
Maturity1/5README and package identity conflict at the first release

Who it’s for

Windows users willing to inspect a young Electron application before running its packaged executable.
Developers comparing YouTube Music wrappers and interested in a plugin-heavy TypeScript codebase.
Users who do not need a Google login and are satisfied with local playlists.
Reviewers prepared to reconcile the README, release archive, and Pear Desktop package metadata themselves.

Who it’s NOT for

Anyone unwilling to run a password-protected ZIP from a new publisher: the README distributes one EXE inside an archive protected with ytm4all.
Teams that require clear source provenance: package.json names Pear Desktop, credits th-ch, and points its repository field to pear-devs/pear-desktop, while this README and release use another identity.
macOS or Linux users seeking a supported download: the v1.0.0 notes promise Windows 10 and 11, and the README only links the EXE archive.
Users who need their Google library and account state: the release advertises no login and local playlists.
Maintainers requiring a passing UI baseline in Debian: 1 of our 6 Playwright tests failed because the app was not launched and visible.

Setup reality

Our sandbox installed 776 pnpm packages in 35 seconds and used 959 MB. The build succeeded in 12 seconds. Tests failed after 22 seconds: 5 passed and 1 failed. The failing Playwright case expected the Pear Desktop app to launch and be visible.

The published user path is different from the source path: download a password-protected ZIP, extract one Windows EXE with ytm4all, and run it. The release says no login is required. Source development requires Node 22 or later and pnpm 11 or later according to package.json.

Our lab ran in an unprivileged Debian container, while the release targets Windows 10 and 11. The test log does not say whether the visibility failure came from the container display environment or the application, so we do not assign a cause.

The README promises a portable Windows music client

The user-facing pitch is short: download a ZIP, extract it with the password ytm4all, and run youtube-music-free.exe. The README says the client streams audio like a browser, does not download tracks or bypass DRM, and is not affiliated with Google. Search, background playback, local playlists, media keys, and dark mode are the named features.

Release v1.0.0 narrows the supported platform to Windows 10 and 11. It says the app needs no login and stores playlists locally, which suits someone who wants a disposable player rather than their existing YouTube Music account. That same choice rules out users who expect subscribed artists, liked songs, cloud playlists, or account history to appear. The README does not explain how catalog availability or playback changes when YouTube alters its service.

Package metadata identifies a different project and author

The checked-out package.json does not describe ytm4all version 1.0.0. It declares a package named youtube-music at version 3.12.0, uses the product name YouTube Music, credits th-ch, and sets the repository field to pear-devs/pear-desktop. Its description calls the code a YouTube Music desktop app with custom plugins. The failing test also names Pear Desktop.

That mismatch may have an explanation, but neither the README nor the v1.0.0 notes provides one. A buyer should not have to infer whether this is a fork, a repackaging, or a renamed build. Clear provenance matters more when the distributed artifact is a password-protected EXE and the visible repository identity differs from the package's author and repository fields. Until documented, inspect the source and build the executable yourself.

What happened when we ran it

Our unprivileged Debian sandbox installed 776 pnpm packages in 35 seconds, using 959 MB on disk. commit 1a7c978 contained 412 files, about 33,598 lines of source, and a 6.4 MB checkout. The build succeeded in 12 seconds. We found 7 CI workflow files, a tests directory, and monorepo workspaces, but no Dockerfile.

The Playwright test step failed with exit code 1 after 22 seconds. Five tests passed and one failed in 15.6 seconds of reported Playwright time. The failed case is named Pear Desktop App - With default settings, app is launched and visible. Its error points to tests/index.test.js and an error-context Markdown file.

The log tail does not state whether Electron failed to start, started without a usable display, or opened invisibly for an application reason. Because the sandbox had no desktop secrets and ran as an unprivileged container, more than one explanation is possible. We report the failed visibility assertion, not a diagnosis. The successful 12-second build shows the source compiled in that environment.

Source development is much larger than the one-EXE pitch

The source requires Node 22 or later and pnpm 11 or later. It uses Electron, Vite, Solid, Playwright, an ad blocker, media libraries, local configuration storage, updater code, and youtubei.js. Build scripts target Windows, macOS, Linux, and ARM packages even though this repository's public README only offers the Windows archive. A contributor therefore inherits a full cross-platform Electron application rather than a tiny launcher.

Our install's 776 packages and 959 MB are the practical measure of that difference. The repository offers scripts for linting, formatting, type checking, packaging, and platform releases. What it does not document is how the source at version 3.12.0 produces the public v1.0.0 binary, which commit built the archive, or why the repository field points elsewhere. Reproducible build instructions would answer more than another feature list.

No login trades account features for a smaller data footprint

A no-login player can avoid handing Google credentials to another desktop wrapper. Local playlists also keep that list on the machine according to the README. Those are sensible privacy properties if implemented as described. They do not make the application anonymous: streaming requests still reach YouTube, and an Electron client has network access plus local file and update code.

The README's disclaimer says it streams like a browser and performs no DRM bypass. It does not document telemetry, update signing, playlist file location, export, or the behavior of its ad-blocking dependency. Users should block automatic trust, watch network destinations, and keep a recoverable copy of local playlists. With 0 open issues and pull requests shown by GitHub, the tracker offers little public operating history.

One August release is too little history for the provenance gap

GitHub showed 836 stars, an MIT license, 0 open issues and pull requests, and a last push on August 11, 2026. Release v1.0.0 was published the same day and calls itself the first public release. Fresh activity is clear, but there is no series of releases here showing how updates, regressions, or service breakage are handled.

The measured build is better than a repository containing only an opaque binary. The 5 passing tests are also useful. Neither result resolves why the package points to Pear Desktop or how the passworded EXE maps to this commit. That unanswered chain is the deciding fact. Try ytmdesktop/ytmdesktop or the declared Pear Desktop source before trusting this release on a daily Windows account.

Alternatives

ProjectWhat it isPick it when
YouTube Music DesktopAnother established desktop wrapper for YouTube Music with remote-control integrations.pick this instead when a longer-running project and companion integrations are more important than a portable EXE.
Pear DesktopThe repository named by this checkout's package metadata and author fields.pick this instead when you want to assess the source identity declared inside `package.json` directly.

What people are saying

  1. [velocity-scout] sohaibdevv/youtube-music

Sources

  1. youtube-music README
  2. youtube-music package metadata
  3. youtube-music v1.0.0 release
  4. Pear Desktop repository

More web reviews

axios · super-productivity · Graphite · fastify · tabler · go-zero · the whole board →