Open-source project
maxrave-dev/SimpMusic avatar
maxrave-dev/SimpMusic

SimpMusic: A YouTube Music Client That Borrows from Spotify, SponsorBlock, and More

Project brief: A cross-platform music app using YouTube Music for backend. Use Spotify Web API and some tricks to get Spotify Canvas and Lyrics Thanks to InnerTune for the idea to get data from YouTube Music.

13,368 stars773 forksKotlinGPL-3.0

At a glance

What is it?
SimpMusic is a cross-platform Kotlin app that streams from YouTube Music and layers on Spotify Canvas, lyrics, SponsorBlock, and ReturnYouTubeDislike. It is beta software with real limitations, but its feature set is unusually broad for a FOSS music player.
Who is it for?
Adopt SimpMusic if you want a free, ad-free YouTube Music client with extra features like Spotify Canvas and SponsorBlock, and you accept beta-level stability and the risk of YouTube breaking things. Do not adopt it if you need a stable, production-grade player or if you rely on official APIs.
Can I use it commercially?
Yes, with conditions. GPL-3.0 is a copyleft licence: if you distribute software that includes it, you must release that software's source code under the same licence. Running it internally without distributing it does not trigger that obligation.
Is it still maintained?
Yes. The repository received new commits within the last day.
What is it written in?
Mainly Kotlin, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on November 14, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • maxrave-dev/SimpMusic13,368 ★ · +3,195
Star history
Repository2026-07-302026-11-14
maxrave-dev/SimpMusic10.2k13.4k

3,195 Stars in the last 107 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial analysis

What SimpMusic Solves and Who It Is For

SimpMusic targets people who want to listen to YouTube Music without the official app's ads, background playback restrictions, or subscription requirement. It is a free and open-source client for Android and Desktop, built with Compose Multiplatform. The README positions it as a FOSS alternative that pulls in features from Spotify, SponsorBlock, and ReturnYouTubeDislike. The intended user is someone who already lives inside YouTube's music catalog but wants a player that feels more like a modern streaming app. That means a user who wants lyrics, Canvas visuals, equalizer presets, and listening analytics without paying for YouTube Music Premium. It is also for tinkerers who accept that the app is in beta and may crash. The README explicitly warns: "This app is in the beta stage, so it may have many bugs and make it crash." So this is not a tool for someone who needs a dependable daily driver out of the box.

The Mechanism: Hidden APIs, Scraping, and Third-Party Services

SimpMusic does not use an official YouTube Music API. Instead, it relies on a hidden API and "some tricks" to get data, as the README states. It credits InnerTune for the idea and SmartTube for help extracting streaming URLs. The core service is a Kotlin module called kotlinYtmusicScraper, which appears to handle the scraping logic. For Spotify features, SimpMusic uses the Spotify Web API to fetch Canvas and lyrics, though lyrics require login for Spotify. SponsorBlock is integrated to skip sponsored segments in YouTube videos, and ReturnYouTubeDislike provides dislike counts. The app also supports synced lyrics from SimpMusic Lyrics, LRCLIB, and YouTube Transcript, with optional AI translation using an OpenAI or Gemini API key. The data flow is a mix of direct scraping, third-party APIs, and user-supplied keys. That means the app's behavior depends on several external services, each of which can change or break independently.

Getting It Running: Downloads, Installers, and Desktop Specifics

The README provides clear download paths. For Android, you can get SimpMusic from F-Droid, IzzyOnDroid, OpenAPK, or GitHub releases. There is also a nightly build page at simpmusic.org. For Desktop, the instructions are specific: on Windows, download SimpMusic-Windows-installer.zip, unzip it and run install.bat; on macOS, use the .dmg file; on Linux, use the .AppImage for all distributions. There is a login guide for the desktop app on the official site. The README notes two desktop limitations: some Linux distributions may have stability issues due to an upstream JetBrains problem, and ARM64 on Windows and Linux should use the x64 build. That last point is a real constraint, not a minor caveat. If you are on an ARM64 Windows machine, you are told to run the x64 build, which may imply emulation or compatibility overhead.

Feature Depth: From Canvas to Wrapped and Listen Together

The feature list is long, and some features are new in recent releases. The README marks as new the Apple Music-style Now Playing, a ten-band equalizer with AutoEq headphone profiles, SimpMusic Wrapped with monthly recap playlists, on-device listening analytics, word-by-word lyrics with romanization, home screen widgets, and Listen Together shared rooms compatible with Metrolist. That is a substantial update. The app also supports 256kbps streams for YouTube Music Premium users, which is a differentiator: the quality tier depends on a paid YouTube subscription. There is a SimpMusic Chart service at chart.simpmusic.org, and the app can play 1080p video with subtitles. For power users, there is Last.fm scrobbling in the Full version, Discord Rich Presence, Android Auto, and a sleep timer. The breadth is impressive, but it also means more surface area for bugs, which the beta warning already acknowledges.

The Real Limitations: Beta Stability, Lyrics Matching, and Privacy Split

The most obvious limitation is stability. The README says player errors are normal because the app depends on YouTube Music, and asks users not to ask about a stable state. That is a direct statement that this is not a polished product. Another limitation is lyrics accuracy. The FAQ explains that lyrics are sourced from LRCLIB and other providers, and matching is done via string and duration heuristics. Sometimes the wrong lyrics appear for a song. That is a genuine failure mode, not a hypothetical. There is also a privacy split: the FOSS version has no tracker or third-party server, but the Full version uses Sentry for crash reporting. If you want no data collection, you must choose the FOSS build. The "Send back to Google" feature, which sends listening history to Google, is optional and only for logged-in users. So the app gives you control, but you have to read carefully to know which version does what.

The Wrong Tool for Some, and a Real Alternative

SimpMusic is the wrong tool if you need a guaranteed-stable player, if you cannot tolerate occasional wrong lyrics, or if you want to avoid any dependence on YouTube's hidden APIs. It is also not ideal for users who want a fully offline experience without any network calls, though it does support caching and offline playback. A real alternative is InnerTune, which the README credits as the inspiration for the YouTube Music data approach. If you want the extra features, SimpMusic is the one to try, with the understanding that more features mean more moving parts.

Maintenance and Upgrade Cost, and License Implications

The project is under active development, with three releases in about three weeks: v2.3.0 on 2026-10-10, v2.4.0 on 2026-10-25, and v2.5.0 on 2026-11-01. The default branch is dev, and contributions require starting from an issue and branching from dev, which suggests a controlled workflow. The license is GPL-3.0, which means any derivative work must also be open source under the same license. That is a consideration if you plan to embed or modify the code for a commercial product. The maintenance cost for users is moderate: you will need to update frequently to keep up with YouTube's changes, and you may encounter regressions between versions. Check the release notes on GitHub, or the changelogs/ directory in the repository, before updating. The desktop app's Linux stability issues are an upstream JetBrains problem, so fixes depend on another project's timeline.

Editorial conclusion

Adopt SimpMusic if you want a free, ad-free YouTube Music client with extra features like Spotify Canvas and SponsorBlock, and you accept beta-level stability and the risk of YouTube breaking things. Do not adopt it if you need a stable, production-grade player or if you rely on official APIs. Before committing, verify which version you need: the FOSS build has no crash reporting, while the Full version uses Sentry. Also check the desktop limitations on Linux and ARM64. If you are on Android, confirm that your device supports the required Android Auto and widget features. The project is actively developed, with releases in October and November 2026, so check the latest release notes for current status.

Frequently asked questions

Is SimpMusic safe to use?

The FOSS version has no tracker and no third-party server for collecting user data, but crash data is collected in the Full version through Sentry. If you enable Send back to Google while signed in, listening history and listening record of video go to Google through the YouTube Music Tracking API.

Is SimpMusic free?

The app is GPL-3.0 and offered as a FOSS build, but several features carry conditions. Streams of up to 256kbps in Opus or AAC are scoped to YouTube Music Premium users, Spotify lyrics require a login, and AI lyrics translation needs your own OpenAI or Gemini API key.

Is SimpMusic legal?

The README says the app uses a hidden YouTube Music API and that Premium quality streaming is limited to YouTube Music Premium users, which leaves the question of terms of service to you.

How do you install SimpMusic on Windows?

Download SimpMusic-Windows-installer.zip, unzip it and run install.bat. The project notes that ARM64 on Windows should use the x64 build instead, and that sign-in on Desktop follows a separate guide hosted on the project site.

How do you install the SimpMusic desktop app?

The file extension decides: .dmg for macOS and .AppImage for Linux, with SimpMusic-Windows-installer.zip and install.bat for Windows. Some Linux distributions may have stability issues, which the project attributes to an upstream JetBrains issue rather than to its own code.

What is the SimpMusic app?

It is a FOSS YouTube Music client for Android and Desktop written in Kotlin with Compose Multiplatform, licensed GPL-3.0 and hosted at simpmusic.org. It pulls YouTube Music data through a hidden API, uses SponsorBlock and Return YouTube Dislike, and calls Spotify Web API for Canvas and lyrics.

Official sources

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/maxrave-dev-simpmusic.svg)](https://hysenlabs.com/projects/maxrave-dev-simpmusic)

Star history chart for your README

markdown
[![Star history](https://hysenlabs.com/chart/maxrave-dev-simpmusic.svg)](https://hysenlabs.com/projects/maxrave-dev-simpmusic)

Was this useful?