SimpMusic README

The project's README from github.com/maxrave-dev/SimpMusic. As one markdown file: README.md.

SimpMusic

A FOSS YouTube Music client for Android and Desktop with many features from
Spotify, SponsorBlock, ReturnYouTubeDislike using Compose Multiplatform to develop.



maxrave-dev%2FSimpMusic | Trendshift

SimpMusic - A FOSS YouTube Music client for Android with many features | Product Hunt

Download

Nightly Build


SimpMusic is available on Desktop now!

kotlin-footguns — the Kotlin, Compose Multiplatform and desktop JVM traps this project ran into the hard way. Star it if it saves you a night.

Features ✨️

(*) 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

More screenshots here.

Data

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?

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:

Please report issues on our Discord server if you find any bugs.

Translation

Crowdin
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 the YouTube videoId parameter. So I need to use some "String Matcher" and "Duration" to 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

Contributing

Contributions are welcome — the full guide lives in CONTRIBUTING.md. The short version:

  1. Start from an issue. Every PR needs an accepted issue behind it — open one first so the change is agreed before the code exists.
  2. Fork and branch from dev (main tracks releases), and fill in the whole PR template — one checkbox is machine-checked.
  3. AI policy. AI-assisted work is welcome; AI-driven work is not:
    • A human must have written or personally reviewed every line and be able to answer review comments about it.
    • Unattended agent submissions (Jules, Devin, and friends) are closed automatically by the triage bot, on sight.
    • Commits carrying AI co-author trailers (Co-Authored-By: Claude/Copilot/…) or "Generated with …" markers are rejected the same way — squash them out first.
    • Repeat offenders are blocked.
  4. Translations go through Crowdin, never PRs editing the string files directly.

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 commercial value or financial intent.

2. A Custom Browser with Content Filtering

SimpMusic acts strictly as a specialized, third-party web browser and client. It simply parses the publicly available website content and APIs of YouTube and YouTube Music, rendering them in a custom user interface. The ad-free experience it provides is fundamentally no different from using a standard web browser (like Chrome, Firefox, or Brave) equipped with a common ad-blocking extension (such as uBlock Origin).

3. Support Content Creators

We deeply respect the hard work of artists, musicians, and content creators. We strongly encourage all users to subscribe to YouTube Premium. Purchasing a Premium subscription is the best way to financially support the creators you listen to and ensure the continued growth of the platform. SimpMusic is built as a proof-of-concept for developers and enthusiasts, not to harm creators' revenues.

4. No Hosting of Copyrighted Material

We do not host, upload, distribute, or store any audio, video, or copyrighted media files on our own servers. All content accessed through this application is stored entirely on Google's/YouTube's servers and remains the property of their respective copyright owners. The app merely acts as a conduit to stream publicly accessible links.

The software is provided "AS IS", without warranty of any kind. The developers of SimpMusic do not encourage or condone piracy. Users are solely responsible for ensuring their usage of this app complies with their local copyright laws and the Terms of Service of the platforms they access.

Because we do not host any media files, we cannot process DMCA takedown requests for audio or video content. However, if you represent a copyright holder or have legal concerns regarding the open-source code itself, please contact us via email at: [email protected]

Contribute

We're looking for more contributors, all contributions are welcome! See our CODE OF CONDUCT

Thanks for all my contributors:

Showcase

This project is following clean architecture and MVVM pattern (in UI, app module).

Dependencies graph

Support & Donations

Special thanks to all supporter ❤️

Visit the website   Discord Server  
Buy me a Coffee   liberapay

MOMO or Vietnamese banking

SimpMusic is sponsored by:





Crowdin and Sentry both have a free enterprise plan for Open-source projects. Follow the URLs:

Past sponsored:


Vercel OSS Program

Check out the Vercel open-source program:

This project is tested with BrowserStack

This project is a part of SimpMusic.org Open-source project by me maxrave-dev

SimpMusic (maxrave-dev/SimpMusic)

Searching Database…

12.1K ·GitHub
SimpMusic
Что это такое?SimpMusic — бесплатный музыкальный клиент с открытым исходным кодом, который воспроизводит музыку из YouTube Music и даёт работу без рекламы, похожую на Spotify, с эквалайзером, текстами песен, SponsorBlock и другими функциями.
Это приложение только для Android или оно работает и на компьютере?Это приложение на Kotlin/Compose Multiplatform, которое работает на Android, а в последнее время также имеет сборки для настольных систем Windows, macOS и Linux.
Как установить его на Windows, macOS или Linux?Скачайте пакет релиза для своей системы: на Windows скачайте .msix и запустите install.bat, на macOS скачайте .dmg, а на Linux скачайте .AppImage (работает в любом дистрибутиве).
Нужен ли мне аккаунт YouTube Music Premium или ключ API, чтобы пользоваться приложением?Для обычного воспроизведения аккаунт не нужен: оно бесплатное и без рекламы. Premium открывает только потоки с битрейтом 256 кбит/с в более высоком качестве, а ключ API от OpenAI или Gemini нужен лишь для необязательной функции перевода текстов песен с помощью ИИ.
Всегда ли он работает без сбоев и ошибок воспроизведения?Нет. Приложение официально находится в бета-версии и может вылетать. Поскольку оно получает данные из скрытого API YouTube Music, ошибки плеера случаются и считаются нормальными, а не багами.
Отправляются ли куда-нибудь данные о том, что я слушаю?В версии FOSS нет трекеров и сторонних серверов для сбора данных. Только полная версия, по сути близкая к платной, отправляет отчёты о сбоях через Sentry, а отправка истории прослушивания в Google — необязательная функция, которая включается по желанию пользователя.
Чем отличаются версии FOSS и полная?Обе бесплатные и имеют одинаковые функции. Полная версия использует Sentry для сбора данных о сбоях, чтобы помочь исправлять ошибки, а версия FOSS ничего не собирает, поэтому её можно выбрать, если вы не хотите отправлять какие-либо данные о сбоях.
Могу ли я слушать музыку синхронно с друзьями?Да. Функция «Listen Together» позволяет создавать общие комнаты, в которых музыка синхронизирована у всех друзей, и она совместима с приложением Metrolist.
Поддерживается ли Android Auto?Да, у SimpMusic богатый интерфейс для Android Auto с онлайн-контентом, так что можно просматривать и запускать музыку через магнитолу автомобиля.
Почему приложение называется SimpMusic?Название — просто сочетание слов «Simple» и «Music». Автору понравилось, как оно звучит, хотя само приложение далеко не простое.
What are similar projects?Levyra-deepsound, SpotiFlyer, Metrolist, PipePipe, ArchiveTune, BitChord, newtube, YumaPlayer
Which topics is it in?mp3, android-application, compose-multiplatform, sponsorblock, youtube-music, playlist, spotify, music-player, video-player, video-streaming, foss, discord
Creator
maxrave-dev
Size
229.6 MB
Stars
12.1K
Updated
CommitOct 16Releasev2.3.0Oct 10
Age
3y
Commits · 90 Days