Repository navigation
Surprise Me
Can't decide what to sing next? The 🎲 button on My Songs picks a random song from your list, with rules you control for what it's allowed to pick from and how it weighs the draw.
The 🎲 floats near the bottom of My Songs. Its full label is "Surprise me — pick a song at random. Press and hold for options."
- Tap it to roll immediately, using whatever rules are currently set.
- Press and hold it to open the rules instead of rolling.
It only shows up when Settings → My Songs → "Enable 'Surprise me' Button" is on ("Tap the 🎲 on My Songs to pick a song at random." — on by default), and only once your list has at least two songs in it.
A roll opens a sheet labelled "Your pick", showing the song as a card (title, artist, genre, year, its "how it went" star, and your Enjoyment rating), with these actions underneath:
| Button | What it does |
|---|---|
| Add to Tonight | Queues the pick into tonight's set. Only shown if the Tonight tab is turned on. |
| Open song | Opens the pick's own detail sheet (tapping the card does the same thing). |
| 🎲 Reroll | Draws again without closing the sheet. A repeat of the song you just drew is unlikely, but possible. |
| Options | Opens the same rules sheet as a press-and-hold on the 🎲. |
| ✕ / outside the sheet / swipe down | Closes it. |
These live under Settings → My Songs, right below the "Surprise me" toggle:
| Rule | Default | What it does |
|---|---|---|
| Skip songs I've sung today | On | Leaves out any song you've already logged a performance for today. If that rules out everything, it picks from the whole list anyway. |
| Favour songs I sing well | On | Weights the draw toward songs with a higher "how it went" star, instead of every song having an equal chance. A song with no rating history counts as your list's average — and even a poorly-rated song always keeps some chance of being picked. |
| Only songs I've never sung | Off | Sticks to songs with no performance history at all. |
| Only my favorites | Off | Sticks to songs you've starred. |
| Draw only from filtered songs | On | Picks only from whatever your current search box and "More filters" sheet are showing, rather than your whole list. Turn it off to draw from everything, regardless of what's on screen. |
Each of the four narrowing rules (everything except "Favour songs I sing well," which only affects weighting) is skipped on its own if turning it on would leave nothing left to draw from — so one overly-strict rule doesn't cancel the whole roll, it gets quietly ignored for that draw.
"Draw only from filtered songs" decides the starting pool — either what's currently on screen or your entire list. From there, the remaining rules narrow that pool one after another: favorites-only, then never-sung-only, then skip-sung-today, each working on what's left after the one before it. Once narrowing is done, "Favour songs I sing well" decides how the actual pick is made from what remains — see below.
The one case that can leave truly nothing to pick from is "Draw only from filtered songs" combined with a search or filter that matches zero songs — since there's no fallback pool to widen out to, a roll in that state does nothing.
With "Favour songs I sing well" off, every song left in the pool has an equal chance — a straight random pick. With it on (the default), the draw is weighted by each song's "how it went" star: better-rated songs come up more often, unrated songs are treated as average, and every song — even a low-rated one — always keeps a small floor chance so nothing becomes permanently undrawable.
The same five rules live in two places, and changing one updates the other immediately — there's no separate "save":
- Press and hold the 🎲 on My Songs, which opens a dedicated sheet with a "🎲 Roll the dice" button at the bottom.
- Settings → My Songs, listed inline below "Enable 'Surprise me' Button."
Press-and-hold has no equivalent gesture for anyone using assistive technology, so the same controls are reachable through Settings as well.
- My Songs — the wishlist the 🎲 draws from, and where the button lives.
- Tonight — what "Add to Tonight" on the result sheet queues the pick into.
- Ratings & history — how the "how it went" star used by "Favour songs I sing well" is worked out.
- Settings reference — the full toggle list, including these rules and where else they show up.