Uh oh!
There was an error while loading.Please reload this page.
- Notifications
You must be signed in to change notification settings - Fork354
A cross-platform music app using YouTube Music for backend
License
maxrave-dev/SimpMusic
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
A FOSS YouTube Music client for Android and Desktop with many features fromSpotify, SponsorBlock, ReturnYouTubeDislike using Compose Multiplatform to develop.





SimpMusic is available on Desktop now!
- Play music from YouTube Music or YouTube for free, without ads and in the background
- Browsing Home, Charts, Podcast, Moods & Genre with YouTube Music data at high speed
- Search everything on YouTube
- Analyze your playing data, create custom playlists, and sync with YouTube Music...
- Spotify Canvas supported
- Play 1080p video option with subtitle
- AI song suggestions
- Customize your playlist, synced with YouTube Music
- Notifications from followed artists
- Caching and offline playback support
- Synced lyrics from SimpMusic Lyrics, LRCLIB, Spotify (require login) and YouTube Transcript - AI lyrics translation (BETA) (*)
- Personalize data (**) and multi-YouTube-account support
- Supports SponsorBlock and Return YouTube Dislike
- Sleep Timer
- Android Auto with online content
- Discord Rich Presence support
- And many more!
(*) Use your OpenAI or Gemini API key
(**) For users who chose "Send back to Google" feature
Warning
This app is in the beta stage, so it may have many bugs and make it crash. If you find any bugs,
please create an issue or contact me via email or Discord server.
Because of depending on YouTube Music, the player error will happen and it's normally, please don't ask me about the stable state of this app.
Morescreenshots here.
- This app uses hidden API from YouTube Music with some tricks to get data from YouTube Music.
- Use Spotify Web API and some tricks to get Spotify Canvas and Lyrics
- Thanks toInnerTune for the idea to get data from YouTube Music. This repo is my inspiration to create this app.
- Special thanks toSmartTube. This repo help me to extract the streaming URL of YouTube Music.
- My app is usingSponsorBlock to skip sponsor in YouTube videos.
- ReturnYouTubeDislike for getting information on votes
- Main lyrics data from SimpMusic Lyrics
- Alternative lyrics data from LRCLIB. More informationLRCLIB
SimpMusic doesn't have any tracker or third-party server for collecting user data in FOSS version. If YouTube
logged-in users enable "Send back to Google" feature, SimpMusic only uses YouTube Music Tracking API to send listening history and listening record of video to Google for better recommendations and
supporting artist or YouTube Creator (For API reference,
seethis).
We collect crash data in the Full version to improve the app.
I useSentry crashlytics to catch all crashes in the Full version.Sentry is the open-source project.If you don't want to be collected crash data, you must use FOSS version.
- Gstreamer: Required for playback audio.
- Yt-dlp: Required for getting streaming URL from YouTube (when using 256kps or higher quality).
- For Windows: Download the file with extension
.msi. - For macOS: Download the file with extension
.dmg. - For Linux: Download the file with extension
.deb(Debian based),.rpm(Red-hat based),.AppImage(all Linux distributions) .
Caution: Not support ARM in Windows and Linux version now, only x86-64. But in macOS version, both ARM and x86-64 are supported.
- No offline playback support.
- No video playback support.
- Very buggy on some Linux distributions (because of Jetbrains not fix).
Please report issues on our Discord server if you find any bugs.
You can help me translate this app into your language by using CrowdinSimpMusic on Crowdin
Lyrics are provided by LRCLIB and other sources. Sometimes lyrics may not match perfectly with YouTube"
videoId" parameter. So I need to use some "String Matcher" and "Duration" for search lyrics. So
sometimes, some songs or videos get the wrong lyrics
Simply, because I love the name. It's a combination of 'Simple' and 'Music'. But SimpMusic is not a simple app, it's all you need for a powerful music streaming app.
More FAQ, joinmy Discord channel
- maxrave-dev: Founder/Developer/Designer
- Owen Connor: Discord Server Admin.
- ilianoKokoro: Discord Server Admin.
- CrazyWolf13: Issues organizer/planner.
We're looking for more contributors, all contributions are welcome!See ourCODE OF CONDUCT
Thanks for all my contributors:
This project is following clean architecture and MVVM pattern (in UI, app module).

Get a free $200 credit over 60 days on DigitalOcean:GET NOW
Crowdin and Sentry both have a free enterprise plan for Open-source projects. Follow the URLs:
Check out the Vercel open-source program:
This project is a part of SimpMusic.org Open-source project by memaxrave-dev
About
A cross-platform music app using YouTube Music for backend
Topics
Resources
License
Code of conduct
Uh oh!
There was an error while loading.Please reload this page.
Stars
Watchers
Forks
Sponsor this project
Uh oh!
There was an error while loading.Please reload this page.
Uh oh!
There was an error while loading.Please reload this page.

















