explaingit

maxrave-dev/simpmusic

9,107KotlinAudience · generalComplexity · 2/5Setup · easy

TLDR

A free, open-source Android and desktop music player that streams from YouTube Music without ads or a subscription, with offline caching, synced lyrics, Android Auto support, and optional AI features.

Mindmap

mindmap
  root((SimpMusic))
    What it does
      YouTube Music player
      No ads or subscription
      Background playback
    Features
      Offline caching
      Synced lyrics
      Android Auto
    Use Cases
      Ad free streaming
      Offline listening
      AI song suggestions
    Setup
      F-Droid or IzzyOnDroid
      FOSS or Full build
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Play YouTube Music songs ad-free in the background without a premium subscription on Android.

USE CASE 2

Cache songs locally for offline listening and sync custom playlists with your YouTube Music account.

USE CASE 3

Enable AI song suggestions or lyrics translation by supplying your own OpenAI or Gemini API key.

Tech stack

KotlinCompose Multiplatform

Getting it running

Difficulty · easy Time to first run · 5min

Playback errors can occur when YouTube changes its internal API, as unofficial extraction methods are used for streaming.

The explanation does not specify the license terms.

In plain English

SimpMusic is a free, open-source music player for Android and desktop that uses YouTube Music as its source of songs and playlists. It lets you play music from YouTube and YouTube Music without ads, without needing a paid subscription for most features, and with the audio playing in the background while you use other apps. It is available through F-Droid and IzzyOnDroid, which are app stores for free and open-source Android software. The app pulls music data from YouTube Music using unofficial methods, not an official API, which is a common approach for free YouTube clients but also means playback errors can occur when YouTube changes things on their end. The README acknowledges this openly and describes the app as still in beta. Feature-wise, it covers most things you would expect from a dedicated music app: home feed, charts, moods and genre browsing, search, custom playlists synced with your YouTube Music account, synced lyrics from multiple sources, caching for offline listening, a sleep timer, crossfade between tracks, and Android Auto support. Some features borrow ideas from other services: Spotify Canvas support (animated video backgrounds), SponsorBlock integration to skip sponsored segments inside music videos, and Return YouTube Dislike to show vote counts. AI song suggestions and AI lyrics translation are listed as beta features and require an OpenAI or Gemini API key you supply yourself. There are two versions: a FOSS build that collects no data at all, and a Full build that uses Sentry crash reporting to help the developer fix bugs. The README explains the difference clearly and lets users choose. The project is written in Kotlin and uses Compose Multiplatform, which is the technology that allows the same codebase to run on both Android and desktop. It credits several other open-source projects for ideas and code related to YouTube data extraction and streaming.

Copy-paste prompts

Prompt 1
How do I install SimpMusic from F-Droid on Android and link it to my YouTube Music account to sync playlists?
Prompt 2
How do I enable offline caching in SimpMusic so I can listen to saved songs without an internet connection?
Prompt 3
What is the difference between the FOSS and Full builds of SimpMusic, and which should I install if I want no data collection?
Prompt 4
How do I set up AI song suggestions in SimpMusic by providing my own OpenAI API key?
Prompt 5
How do I enable SponsorBlock in SimpMusic to automatically skip sponsored segments inside music videos?
Open on GitHub → Explain another repo

← maxrave-dev on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.