whatisgithub

What is simpmusic?

maxrave-dev/simpmusic — explained in plain English

Analysis updated 2026-06-24

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

In one sentence

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

What do people build with it?

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.

What is it built with?

KotlinCompose Multiplatform

How does it compare?

maxrave-dev/simpmusicsquare/okiojetbrains/exposed
Stars9,1079,0049,236
LanguageKotlinKotlinKotlin
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get 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.

So what is it?

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?

Frequently asked questions

What is simpmusic?

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.

What language is simpmusic written in?

Mainly Kotlin. The stack also includes Kotlin, Compose Multiplatform.

What license does simpmusic use?

The explanation does not specify the license terms.

How hard is simpmusic to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is simpmusic for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.