You're three minutes into a track you've been waiting all day to hear. The guitar riff hits its peak. Then, without warning, the music cuts out. A 15-second ad for a car insurance company you'll never buy from blares through your speakers. When the song finally resumes, the momentum is gone.
That's the official YouTube Music experience on a free account. And if you want background playback—the ability to keep music going while you use other apps or lock your phone—you're expected to pay a monthly subscription fee. For many users, these restrictions feel less like premium features and more like deliberate inconveniences designed to push you toward a payment plan.
Enter sohaibdevv/youtube-music: an open-source, lightweight client that streams music from YouTube Music's vast catalog without ads, without subscription requirements, and with full background playback support. It's a community-driven alternative that strips away the friction and gives you just the music.
This article explains what this project is, how it works under the hood, how to install and use it, and what you should consider before making it your primary music player.
At its core, sohaibdevv/youtube-music is a third-party desktop client that connects to YouTube Music's backend and lets you stream audio directly—no web browser, no official app, no ads.
The project is hosted on GitHub under the username sohaibdevv. It's part of a growing ecosystem of independent clients that aim to provide a better user experience than the official offerings. The client is built around a simple philosophy: music playback should be straightforward, uninterrupted, and resource-efficient.
The official YouTube Music app serves two masters: your listening experience and Google's advertising revenue. On a free tier, that means ads. On a paid tier, that means a subscription fee. The app itself is also notoriously heavy, especially on older hardware.
This third-party client doesn't have those constraints. It doesn't need to show ads because it isn't monetized. It doesn't need to restrict background playback because it isn't trying to upsell you. And because it's built with a focus on minimalism, it runs smoothly on machines that would struggle with the official app.
The client doesn't use an official developer API from Google—because one doesn't exist for YouTube Music in the way you might expect. Instead, the developer reverse-engineered the internal endpoints that the official YouTube Music web app uses to communicate with Google's servers. This means the client can talk directly to YouTube Music's catalog, pulling metadata, stream URLs, and playlist data just like the official app does.
Key Takeaway: This isn't a wrapper around the YouTube website. It's a purpose-built client that communicates with YouTube Music's internal API to deliver a native-feeling, ad-free experience.
To understand what makes this client possible, you need a basic grasp of reverse-engineered APIs.
When you use the official YouTube Music website, your browser sends requests to Google's servers. These requests use internal API endpoints—URLs that return JSON data containing everything from search results to audio stream URLs. Google doesn't publish these endpoints for third-party use, but they're discoverable.
A developer can inspect the network traffic of the official site, identify these endpoints, and replicate the requests in their own application. That's what the creator of sohaibdevv/youtube-music did. The client essentially impersonates the official web app, sending the same types of requests and receiving the same responses.
When you search for a song, the client sends a search query to YouTube Music's internal API. The API returns a list of results—titles, artists, album art, durations, and IDs. When you hit play, the client requests a stream URL for that specific video ID. The API responds with a direct audio stream link, which the client plays through its built-in audio engine.
This entire process happens in the background. From your perspective, you're just using a music player. You type a query, results appear, you click, and music plays.
Because the client relies on undocumented endpoints, it's vulnerable to changes on Google's side. If YouTube modifies its internal API—even slightly—the client might stop working. This could mean temporary outages, broken searches, or complete loss of functionality until the developer updates the code.
This is an inherent risk of any reverse-engineered project. It's not a question of if the API will change, but when. The good news is that the open-source nature of the project means fixes can be pushed quickly when issues arise.
This is where things get nuanced. Reverse-engineering APIs isn't inherently illegal, but it can violate a service's Terms of Service. YouTube's ToS explicitly prohibits accessing its content through means other than the official interfaces. Using this client technically puts you in violation of those terms.
That said, the legal landscape isn't clear-cut. You're not pirating content—you're accessing the same free content you could access through a browser, just through a different interface. The client doesn't download music for offline use, nor does it bypass any paywalls. It's a gray area, and you should be aware of that before using it.
Key Takeaway: The reverse-engineered API is both the project's greatest strength and its greatest vulnerability. It enables all the features that make this client appealing, but it also means the client could break at any time if YouTube changes its backend.
Let's take a closer look at what this client actually does, feature by feature.
This is the headline feature. No pre-roll ads, no mid-song interruptions, no banner ads cluttering the interface. You press play, and the music continues until you stop it. For anyone who's endured the official app's ad frequency, this alone justifies the switch.
The client achieves this by simply not implementing ad playback. Ad delivery is part of the official app's architecture; this client just omits it entirely.
Background playback is the second most requested feature for music apps, and it's a standard expectation for any serious player. With this client, you can minimize the window, switch to a different application, or even lock your screen, and the music keeps playing.
On desktop operating systems, this is handled through the system's audio session management. The client continues running in the background, managing its own audio output independently of the main window. It's a seamless experience that makes multitasking with music effortless.
The search interface is clean and direct. Type a query, and the client queries YouTube Music's API, returning results organized by category. You can search for:
Results are displayed with cover art, duration, and artist information, making it easy to find exactly what you're looking for.
The client includes a full playlist manager. You can create new playlists, add songs to them, reorder tracks, and remove songs you no longer want. Playlists are stored locally, and the client maintains the references to the underlying YouTube Music tracks.
This means you can build a library of your favorite tracks without needing a YouTube account or a premium subscription. Your playlists are yours, stored on your machine, ready to play whenever you open the client.
One of the most practical advantages of this client is its efficiency. The official YouTube Music app—especially the web version—is notoriously resource-hungry. A single browser tab running YouTube Music can consume hundreds of megabytes of RAM.
This client is built to be lean. It doesn't load a web browser engine, doesn't render video, and doesn't maintain a complex UI. As a result, it runs comfortably on older machines with modest specs. If you have a low-end laptop or a home server that doubles as a music player, this client is a strong fit.
Key Takeaway: The combination of ad-free playback, background audio, and low resource usage makes this client particularly attractive for users on older hardware or those who simply want a no-frills music player.
The project is hosted on GitHub. To download the client, navigate to the repository page, look for the "Releases" section, and download the latest release for your operating system. Alternatively, you can clone the repository and build it from source if you prefer.
Windows: Download the .exe installer or portable build from the releases page. Run the installer and follow the on-screen prompts. The portable version doesn't require installation—just extract and run.
macOS: Download the .dmg or .app bundle. Open the disk image and drag the application to your Applications folder. If macOS blocks the app because it's from an unidentified developer, go to System Preferences → Security & Privacy and allow it.
Linux: Download the .AppImage or .deb package depending on your distribution. For AppImage, make the file executable (chmod +x) and run it. For .deb, use sudo dpkg -i or your package manager's install command.
Upon first launch, the client may ask you to sign in with your YouTube account. This is optional for basic streaming but may be required for certain features like accessing your existing playlists or liking videos. If you skip sign-in, you can still search and play music.
The settings menu lets you configure audio quality, playback behavior, and interface preferences. Most defaults are sensible, so you can start listening immediately without tweaking anything.
That's the core workflow. The interface is minimal by design—there's no learning curve.
Maria has a 2012 laptop that she uses for writing. The official YouTube Music web app lags, and ads break her concentration. She installs sohaibdevv/youtube-music, and the client runs smoothly alongside her word processor. She searches for a lo-fi playlist, presses play, and writes for hours without interruption.
David is a developer who needs music while coding. With the official app, he'd have to keep a browser tab open, which drains battery and memory. This client lets him minimize the window, focus on his IDE, and keep the music flowing. The background playback is seamless—he never thinks about it.
Aisha is a DJ who curates playlists for her sets. She uses the client to build playlists for different moods and occasions. The search function helps her find tracks quickly, and the playlist manager lets her reorder songs with simple drag-and-drop. She exports her playlist structure to use elsewhere, confident in her curation.
Tom is a developer who appreciates the project and wants to contribute. He forks the repository, implements a lyrics display feature, and submits a pull request. The maintainer reviews his code, merges it, and the feature becomes available to all users in the next release. This is open-source software in action—users become contributors, and the project improves collectively.
Key Takeaway: The client fits a variety of use cases, from casual listening to professional curation, and its open-source nature invites community involvement.
No tool is perfect, and this client has its share of caveats.
As mentioned earlier, using a reverse-engineered client violates YouTube's Terms of Service. In practice, individual users are unlikely to face consequences, but it's a risk nonetheless. Google could theoretically take action against the project or its users, though this is rare for non-commercial tools.
The client's functionality is tied to YouTube's internal API, which can change at any time. When that happens, the client may break until the developer releases a fix. This can be frustrating, especially if you rely on the client for daily listening.
Because this is a community-driven project, there's no guarantee of regular updates or support. The developer may lose interest, get busy, or abandon the project entirely. If that happens, the client will eventually stop working as YouTube changes its backend.
The client sends requests to YouTube's servers, which means Google can still see your listening activity. Additionally, because the project is open-source, you should review the code before running it—especially if you're concerned about security. Most users trust the project, but it's always wise to verify what you're installing.
Key Takeaway: The client is a powerful tool, but it exists in a gray area. Understand the risks before you commit to it as your primary music player.
Yes. The client is completely free to download and use. There are no hidden costs, no premium tiers, and no in-app purchases.
No. The client streams music without requiring any subscription. It accesses the same free content available on YouTube, just without the ads and restrictions.
Yes. Background playback is a core feature. Music continues playing when the window is minimized or the screen is locked.
Yes. The client does not display or play any advertisements.
Yes. The client includes full playlist management functionality. You can create, edit, and reorder playlists.
No. The client is an independent, community-driven project. It is not affiliated with, endorsed by, or supported by Google or YouTube.
The client supports Windows, macOS, and Linux. Check the GitHub releases page for the latest builds for your operating system.
The client uses a reverse-engineered API to communicate with YouTube Music's internal servers. It sends the same types of requests as the official web app.
This is a gray area. The client doesn't pirate content, but it does violate YouTube's Terms of Service. Individual users are unlikely to face legal action, but the risk exists.
Visit the GitHub repository at sohaibdevv/youtube-music and navigate to the Releases section to download the latest version.
sohaibdevv/youtube-music is a compelling alternative for anyone frustrated with the official YouTube Music experience. It delivers on the essentials—ad-free streaming, background playback, search, and playlist management—in a lightweight package that respects your system resources.
The reverse-engineered API is both a marvel and a liability. It enables features that the official app gates behind a subscription, but it also makes the client dependent on YouTube's goodwill and the maintainer's availability. If you're comfortable with that trade-off, this client offers one of the cleanest music streaming experiences available.
Is it for everyone? No. If you're deeply invested in the YouTube ecosystem, need offline downloads, or require official support, the official app is still your best bet. But if you want a no-nonsense, ad-free music player that just works, this project deserves your attention.
The project is open-source, which means you can explore the code, report issues, and even contribute features of your own. Whether you're a listener looking for a better experience or a developer who wants to help improve the tool, there's a place for you in the community.
Ready to make the switch? Visit the GitHub repository to download the client, explore the source code, and join the community of contributors.