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.
User Interface
| 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 | #8ECAE6 |
| Translucent 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 13+ | Restyles the bottom navigation bar and mini player with an iOS-style glass effect | Off |
Wallpaper colours
Wallpaper derives the palette from your device wallpaper (Material You). The option only appears on Android 12 or newer — on older Android versions and on desktop it is not offered at all, so the picker just shows Default and Custom.
Paired with the Dark theme, SimpMusic keeps the background pure black rather than the tinted grey Material You would normally use, so the OLED look survives.
Liquid glass is Android-only
The effect swaps in a translucent bottom navigation bar and changes how the mini player sits above it, with its own layout on tablets. It needs Android 13 or newer, and the desktop app switches it back off on its own — there is no glass bar to apply it to there.
Content
| 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 | Show your device favourites and your YouTube Liked Music as one list (the two are separate) | Off |
| Using Proxy | Route traffic through a proxy (reveals proxy options) | Off |
Proxy (shown only when "Using Proxy" is on)
| 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 | — |
Audio (Android only)
| Setting | What it does | Default |
|---|---|---|
| Normalize Volume | Balance media loudness | Off |
| Skip Silent | Skip silent parts | Off |
| Open system equalizer | Hand off to your device's own EQ app | — |
The equalizer is your system's, not SimpMusic's
SimpMusic has no built-in equalizer. This opens whatever EQ your phone or ROM provides, and hands it SimpMusic's audio session — so the adjustments you make there apply to SimpMusic's playback specifically, not to every app at once.
If no EQ app is installed, SimpMusic says so instead of opening a blank screen. The option is Android-only; the desktop app has nothing to hand off to.
Playback
| 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 |
Crossfade
| Setting | What it does | Default |
|---|---|---|
| Crossfade (BETA) | Fade between tracks | Off |
| Crossfade Duration | Auto, or 1–30 s. Auto beatmatches tempo and key when the data is available | 5 s |
| DJ-Style Transition — Android | Apple-Music-style filter sweeps | On |
See Playback & Queue for details.
Lyrics
| 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) | — |
AI
| 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 |
Spotify
| 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 |
Discord integration
| 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 |
Last.fm (Full build only)
| Setting | What it does | Default |
|---|---|---|
| Log in to Last.fm | Sign in to your Last.fm account; shows your username once signed in | — |
| Enable scrobbling | Send what you play to your Last.fm profile (login required) | Off |
The whole group is hidden — not greyed out — in any build without Last.fm credentials: every
FOSS build, and a self-built Full build whose local.properties carries no API key.
See Accounts & Login for the sign-in flow and what gets sent.
SponsorBlock
| 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 | — |
Storage (Android only)
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 |
Backup
| 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 | — |
| Import playlists | Load a playlist file made with the converter on simpmusic.org | — |
About us
| 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.
