SimpMusic
A cross-platform music app using YouTube Music for backend
Install / Use
/learn @maxrave-dev/SimpMusicREADME
SimpMusic is available on Desktop now!
Features ✨️
- Play music from YouTube Music or YouTube for free, without ads and in the background
- High quality up-to 320kbps stream (NEW)
- 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
- Powered your experience with SimpMusic Chart (https://chart.simpmusic.org/)
- 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
- Crossfade with DJ-style like Apple Music (NEW)
- Synced lyrics from SimpMusic Lyrics, LRCLIB, Spotify (require login) and YouTube Transcript - AI lyrics translation (BETA) (*)
- Personalize data (**) and multi-YouTube-account support
- Local "scrobble" like Last.fm (NEW)
- 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.
Screenshots
<p align="center"> <img src="https://github.com/maxrave-dev/SimpMusic/blob/main/asset/screenshot/01.png?raw=true" width="200" /> <img src="https://github.com/maxrave-dev/SimpMusic/blob/main/asset/screenshot/02.png?raw=true" width="200" /> <img src="https://github.com/maxrave-dev/SimpMusic/blob/main/asset/screenshot/03.png?raw=true" width="200" /> <img src="https://github.com/maxrave-dev/SimpMusic/blob/main/asset/screenshot/04.png?raw=true" width="200" /> </p> <p align="center"> <img src="https://github.com/maxrave-dev/SimpMusic/blob/main/asset/screenshot/05.png?raw=true" width="200" /> <img src="https://github.com/maxrave-dev/SimpMusic/blob/main/asset/screenshot/17.png?raw=true" width="200" /> <img src="https://github.com/maxrave-dev/SimpMusic/blob/main/asset/screenshot/07.png?raw=true" width="200" /> <img src="https://github.com/maxrave-dev/SimpMusic/blob/main/asset/screenshot/08.png?raw=true" width="200" /> </p> <p align="center"> <img src="https://github.com/maxrave-dev/SimpMusic/blob/main/asset/screenshot/09.png?raw=true" width="200" /> <img src="https://github.com/maxrave-dev/SimpMusic/blob/main/asset/screenshot/10.png?raw=true" width="200" /> <img src="https://github.com/maxrave-dev/SimpMusic/blob/main/asset/screenshot/11.png?raw=true" width="200" /> <img src="https://github.com/maxrave-dev/SimpMusic/blob/main/asset/screenshot/12.png?raw=true" width="200" /> </p> <p align="center"> <img src="https://github.com/maxrave-dev/SimpMusic/blob/main/asset/screenshot/13.png?raw=true" width="200" /> <img src="https://github.com/maxrave-dev/SimpMusic/blob/main/asset/screenshot/14.png?raw=true" width="200" /> <img src="https://github.com/maxrave-dev/SimpMusic/blob/main/asset/screenshot/15.png?raw=true" width="200" /> <img src="https://github.com/maxrave-dev/SimpMusic/blob/main/asset/screenshot/16.png?raw=true" width="200" /> </p> <p align="center"> <img src="https://github.com/maxrave-dev/SimpMusic/blob/main/asset/screenshot/06.png?raw=true" width="800" /> </p>More screenshots here.
Data
- 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 to InnerTune for the idea to get data from YouTube Music. This repo is my inspiration to create this app.
- Special thanks to SmartTube. This repo help me to extract the streaming URL of YouTube Music.
- My app is using SponsorBlock to skip sponsor in YouTube videos.
- ReturnYouTubeDislike for getting information on votes
- Main lyrics data from SimpMusic Lyrics
- Alternative lyrics data from LRCLIB. More information LRCLIB
Privacy
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,
see this).
We collect crash data in the Full version to improve the app.
Full or FOSS version
I use Sentry 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.
Desktop app
Which file should I download?
- For Windows: Download the file with extension
.msi. - For macOS: Download the file with extension
.dmg. - For Linux: Download the file with extension
.AppImage(all Linux distributions)
Log in guide: https://www.simpmusic.org/blogs/en/how-to-log-in-on-desktop-app
Discord login guide: https://gist.github.com/MarvNC/e601f3603df22f36ebd3102c501116c6
Some limitations on Desktop app:
- Very buggy on some Linux distributions (because of Jetbrains not fix).
Please report issues on our Discord server if you find any bugs.
Translation
<br/>
You can help me translate this app into your language by using Crowdin SimpMusic on Crowdin
Special thanks to all translators on Crowdin ❤️
FAQ
1. Wrong Lyrics?
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
2. Why the name or brand is "SimpMusic"?
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, join my Discord channel
Legal Disclaimer & Terms of Use
1. 100% Free, Open-Source & Strictly Non-Commercial
SimpMusic is a fully open-source project (FOSS) created purely for educational purposes and personal use. We do not sell this application, nor do we monetize it in any way. There are no advertisements, no premium features, no subscriptions, and no hidden fees within the app. This project has absolutely no
Related Skills
docs-writer
98.4k`docs-writer` skill instructions As an expert technical writer and editor for the Gemini CLI project, you produce accurate, clear, and consistent documentation. When asked to write, edit, or revie
model-usage
325.6kUse CodexBar CLI local cost usage to summarize per-model usage for Codex or Claude, including the current (most recent) model or a full model breakdown. Trigger when asked for model-level usage/cost data from codexbar, or when you need a scriptable per-model summary from codexbar cost JSON.
arscontexta
2.8kClaude Code plugin that generates individualized knowledge systems from conversation. You describe how you think and work, have a conversation and get a complete second brain as markdown files you own.
docs
High-performance, modular RAG backend and "Knowledge Engine" Built with Go & Gin, featuring Git-Ops knowledge sync, pgvector semantic search, and OpenAI-compatible model support.
