User Guide
Settings Reference Every settings group in SimpMusic explained, with default values.
This page documents each settings group, in the order it appears in the app. Some groups and
options are Android-only and are marked as such.
Setting What it does Default Theme App theme mode: System / Dark / Light Dark Theme color Where accent colour comes from: Default / Wallpaper / Custom Default Custom color Seed colour used when Theme color is Custom #8ECAE6Translucent bottom navigation bar See content behind the bottom bar On Blur fullscreen lyrics effect Blur the fullscreen lyrics background Off Blur player background Blur the Now Playing background Off Enable liquid glass (BETA) — Android iOS-style glass effect in some places Off
Wallpaper colours
Choosing Wallpaper as the theme colour source pulls the palette from your device
wallpaper (Material You). It only has an effect on Android versions that expose dynamic
colour; elsewhere the app falls back to the default palette.
Setting What it does Default YouTube Account Manage / switch Google accounts, or use Guest — Language App UI language (changing restarts the app); 26 languages English (en-US) Content Country Region used for YouTube Music content VN Quality Audio streaming quality: Low 66 / Medium 129 / High 256 kbps (Premium) Low 66 kbps Download quality Audio quality for downloads Low 66 kbps Play video for video track instead of audio only Play video for MVs, lyric videos, podcasts Off Video Quality Streaming resolution: 1080p / 720p / 360p 720p Video download quality Resolution for video downloads 720p Send back listening data to Google Upload history for better recs (signed-in only) Off Play explicit content Off = skip explicit tracks On Keep showing your YouTube playlist when offline Save YT playlists locally Off Local tracking listening history Log plays locally to power Analytics Off Combine local and YouTube liked songs Merge both liked lists into one view Off Using Proxy Route traffic through a proxy (reveals proxy options) Off
Setting What it does Default Proxy type HTTP or Socks HTTP Proxy host Proxy hostname — Proxy port Proxy port 8000 Proxy username / password Optional credentials —
Setting What it does Default Normalize Volume Balance media loudness Off Skip Silent Skip silent parts Off Open system equalizer Launch your device's system EQ —
Setting What it does Default Save Playback State Remember shuffle & repeat modes Off Save Last Played Remember last track and queue Off Kill service on exit — Android Stop the player when you exit the app Off Keep service alive — Android Prevent the system from killing the player service Off
Setting What it does Default Crossfade (BETA) Fade between tracks Off Crossfade Duration Auto or 1–30 s (Auto needs 320 kbps + BPM) 5 s DJ-Style Transition — Android Apple-Music-style filter sweeps On
See Playback & Queue for details.
Setting What it does Default Main Lyrics Provider SimpMusic / YouTube Transcript / LRCLIB / BetterLyrics SimpMusic Translation Language 2-letter code for translation (empty = app language) — YouTube Subtitle Translation Language Preferred 2-letter code for YT subtitles — Help build lyrics database Send your saved lyrics to SimpMusic Lyrics Off Contributor name / email Credit for contributions (when "help build" is on) —
Setting What it does Default AI provider OpenAI / Gemini / Custom OpenAI Compatible Gemini Your AI API Key Your provider API key — Custom AI model ID Override model (e.g. gemini-2.0-flash, gpt-4o) — Custom Base URL / Headers For Custom OpenAI endpoints only — Use AI Lyric Translation Translate lyrics with AI (needs an API key) Off
See Lyrics & AI Translation .
Setting What it does Default Log in to Spotify Sign in (needed for lyrics & Canvas) — Enable Spotify Lyrics Use Spotify's lyrics (login required) Off Enable Canvas Show Spotify Canvas visuals (login required) Off
Setting What it does Default Log in to Discord Sign in to Discord — Enable rich presence Show now-playing on your Discord profile (login required) Off
Setting What it does Default Enable SponsorBlock Skip non-music segments (online only) Off Select skip-segment behavior Choose which of the 9 categories to skip —
See SponsorBlock & Dislikes .
A colored bar breaks down storage use (downloaded, player, canvas, thumbnail, database, free).
Setting What it does Default Player Cache Clear the streaming cache — Downloaded Cache Clear downloaded songs — Thumbnail Cache Clear cached thumbnails — Spotify Canvas Cache Clear cached Canvas videos — Limit Player Cache Cap player cache: 100 MB – 8 GB, or unlimited Unlimited
Setting What it does Default Backup downloaded data Include downloaded songs' data in backups Off Auto backup — Android Auto-save to Downloads/SimpMusic Off Backup frequency Daily / Weekly / Monthly (when auto-backup is on) Daily Keep backups How many backups to retain: 3 / 5 / 10 / 15 5 Backup Your Data Manually export a .backup file — Restore Your Data Restore from a backup file —
Setting What it does Default Version App version; tap to open the Credits screen — Automatic check for update Check for updates on launch On Update channel F-Droid or SimpMusic GitHub Release SimpMusic GitHub Release Check for update Check now — maxrave-dev / Developer Blog / Buy me a coffee Links to GitHub, blog, and sponsorship — Blog notification — Android Notify when a new developer blog post is published On Third party libraries Open-source licenses —
Defaults above reflect what the app persists. A few options behave slightly differently from
their on-screen initial state (for example, Kill service on exit persists as Off). When in
doubt, the value shown in the app is what's active.
