Repository navigation
Settings Reference
Every toggle and dial in Settings (⋮ menu → Settings), grouped into the same collapsible sections the app uses, in the same order. Every flag defaults to how the app already behaved before the setting existed, so a fresh install needs no setup.
| Setting | Default | What it does |
|---|---|---|
| Enable "Tonight" Tab | On | An on-deck set you build, reorder and check off. Off hides the tab; your set is kept. See Tonight. |
| Setting | Default | What it does |
|---|---|---|
| Enable Auto-fill Year & Genre | On | Attempt to lookup year and genre when you add, open, or import songs. See Metadata & album art. |
| Enable "Surprise me" Button | On | Tap the 🎲 on My Songs to pick a song at random. See Surprise me. |
| ↳ Skip songs I've sung today | On | (Shown only when Surprise me is on.) If that rules out everything, it picks from the whole list anyway. |
| ↳ Favour songs I sing well | On | (Shown only when Surprise me is on.) No helper text in the app; weights the draw toward songs you rate well. |
| ↳ Only songs I've never sung | Off | (Shown only when Surprise me is on.) No helper text in the app; restricts the draw to songs with no logged performances. |
| ↳ Only my favorites | Off | (Shown only when Surprise me is on.) No helper text in the app; restricts the draw to favorited songs. |
| ↳ Draw only from filtered songs | On | (Shown only when Surprise me is on.) No helper text in the app; draws from the list as currently filtered on My Songs, rather than your whole list. |
| Float favorites to the top | On | Keep favorites above the rest, whatever the sort. |
| Confirm before deleting a song | Off | Ask before a swipe removes a song. Off leaves Undo as the only way back. |
| Enable Song Spelling Assistant | On | Flag a name that's one slip from the provider's spelling. |
| Scroll to song when favorited | On | Starring a song scrolls the list to its new position. |
| Show album art on song cards | On | Use each song's cover as its card background. Covers are cached on this device. See Metadata & album art. |
| Show song tags | On | Your own labels — "duet", "closer" — as chips on a song, filterable. Off hides them; they're kept. |
| Setting | Default | What it does |
|---|---|---|
| Enable "Find on YouTube" Button | On | Opens a YouTube search from a song's detail sheet. See Lyrics & quick links. |
| Enable "Find on Spotify" Button | On | Opens a Spotify search from a song's detail sheet. |
| Enable "Lyrics" Button | On | Look a song's lyrics up from LRCLIB and read them in the app. |
| Enable Lyrics Caching | On | Keep looked-up lyrics so they reopen instantly offline. |
| Setting | Default | What it does |
|---|---|---|
| Enable KaraFun Features | On | The "Find on KaraFun" button on a song, a venue's catalog button and QR code, and the KaraFun ID field when you edit a venue. Off hides all of them; venues keep any ID already saved. See Venues. |
| Setting | Default | What it does |
|---|---|---|
| Enable Venue Auto-detect | On | Switch to the nearest saved venue as you move. Foreground only. See Venues. |
| ↳ Re-check location every | 5 min | (Shown only when auto-detect is on.) How often to look again while the app is open. Options: 2 min, 5 min, 10 min, 15 min, 30 min. |
| ↳ Default Venue Radius | 250 ft (75 m) | (Shown only when auto-detect is on.) Wider for a big room with a car park; tighter on a busy street. Options: 50 ft, 100 ft, 250 ft, 500 ft, 1000 ft — stored as metres underneath (15/30/75/150/300 m) regardless of which unit is displayed. |
| ↳ Show distances in feet | On | (Shown only when auto-detect is on.) Displays the radius and re-check options above in feet instead of metres. |
| Venue history length | 5 | Always visible — not gated on auto-detect. Go-to songs and recent performances listed per venue. Options: 3, 5, 10. |
| Setting | Default | What it does |
|---|---|---|
| Enable Performance Rating | On | Ask "how did it go?" when you log one. Off still logs it, and takes a note. See Ratings & history. |
| Favour recent form | Off | Fade older performances so current form leads the star. Your logged ratings are untouched. |
| ↳ "Recent" means | 6 months | (Shown only when "Favour recent form" is on.) How far back a performance still counts as current form. Options: 1 month, 3 months, 6 months, 1 year. |
| Trust a rating after | 3 performances | Always visible — not gated on "Favour recent form". Until then its star leans on your list average. Options: 1 performance, 3 performances, 8 performances. |
| Setting | Default | What it does |
|---|---|---|
| Enable Update Notifications | On | Show a banner at startup when a newer release is out. |
| Enable Haptic Feedback | On | A short buzz confirms a press-and-hold. |
| Enable 24-hour Time | Off | Show 21:30 rather than 9:30 PM. |
| Undo window | 5 seconds | How long Undo stays after you remove a song, a venue, or a performance from the history. Options: 5 seconds, 10 seconds, 30 seconds. |
| Launch Tab | Smart | "Smart" opens Tonight only when a set is waiting. Options: Smart, My Songs, Tonight. |
| Music catalogue region | United States | Which country's catalogue auto-fill searches. Affects new lookups only. Options: United States, United Kingdom, Canada, Australia, Ireland, New Zealand, Germany, France, Spain, Italy, Netherlands, Sweden, Mexico, Brazil, Japan. |
| Import lookup speed | Normal | Faster finishes sooner, but risks the provider refusing requests. Options: Gentle, Normal, Fast. See Import & export. |
| Action | What it does |
|---|---|
| Replay the tutorial | Walk through the guided tour again. Not a persisted toggle — a one-shot action you can repeat any time. |
Each action shows a live count of what it would remove, and is disabled when that count is zero.
| Action | Removes | Comes back? |
|---|---|---|
| Clear lyrics cache | Every cached lyrics lookup on this device. | Yes — re-looked-up from LRCLIB the next time you open that song's lyrics. Clears immediately, no confirmation. |
| Clear album art cache | Every cached cover-art image on this device. | Yes — re-downloaded the next time you view those songs. Clears immediately, no confirmation. |
| Clear song list | Every song in your My Songs list, including its performance history. | No. Asks you to confirm first, then it's gone for good. |
The five "Surprise me" toggles under My Songs above (skip sung today, favour well-sung, never-sung only, favorites only, draw only from filtered songs) are the exact same settings shown on the 🎲's press-and-hold options sheet on My Songs — changing one updates the other immediately. A long press has no assistive-tech equivalent, so the same controls are reachable through Settings too. See Surprise me.
Settings live in the device's own app-settings storage — not a file you can open, and not part of your song list or Tonight set. They're shared by every singer on the device, not kept separately per singer like a My Songs list or Tonight set (see Singers) — switching who's singing never changes anything on this page. Like the rest of the app's on-device data, settings survive being updated to a new version, but are erased if the app is uninstalled.