Repository navigation
Ratings and History
Every song tracks two separate ratings — how a specific performance went, and how much you enjoy singing the song overall — plus a full history of every time you've sung it. The star shown next to a song isn't a plain average of your scores; this page explains both ratings, the history behind them, and the math behind that star.
The song detail sheet shows both, one row each:
| How it went | Enjoyment | |
|---|---|---|
| What it measures | How well that one performance went | How much you like singing this song, period |
| Scope | Logged fresh every time you sing it | One value per song |
| Star color | Red | Blue |
| Set from | The rating prompt when you log a performance (or edited later in performance history) | Tap the stars on the Enjoyment row any time |
| Shown as | A confidence-weighted star (see below) plus a number like 4.5
|
Your own rating, exactly as set — no weighting |
A song can be a joy to sing and still have a shaky "how it went" history, or the reverse — the two ratings never affect each other. Tapping an already-selected star clears it back to unrated; that's the only way to remove a rating.
Every star row — how it went, enjoyment, and the rating prompt — uses the same five tooltips when you tap or hold on a star:
| Stars | Label |
|---|---|
| 1 of 5 | Not confident |
| 2 of 5 | Shaky |
| 3 of 5 | Okay |
| 4 of 5 | Confident |
| 5 of 5 | Nailed it |
A performance gets logged from two places:
- Tonight — checking a song's ✓ off.
- My Songs — the song's detail sheet, Log performance (or Log another performance once it's been sung before).
With Enable Performance Rating on (Settings → Singing & Ratings — "Ask 'how did it go?' when you log one. Off still logs it, and takes a note."), both routes open the same sheet: "How did it go?", subtitled with the song's name. Tap a star, optionally add a note, then Save — or Skip — just log that I sang it if you don't want to rate it. A When field sits above the note, set to right now — change it if you're logging a sing you forgot at the time, and the performance is filed under the date and time you pick. Pulling the sheet down also logs it unrated, the same as Skip; only the ✕ or tapping outside the sheet backs out without logging anything.
With the setting off, logging still happens, without the rating step:
- From My Songs, the same sheet opens but retitled "Have any notes?" — no stars, an optional note field and Save.
- From Tonight, checking the song off logs it immediately with no prompt at all.
Either way, the performance is stamped with today's date, your note (if any), and whichever venue you're currently checked into (see Venue attribution below).
Open a song's full history from its detail sheet: tap the date under Last (only shown once the song has been sung at least once). The sheet's subtitle repeats the song's name plus the weighted star and total performance count — e.g. "Diamonds · 4.7★ over 12 performances".
Each past performance is its own row, newest first, with:
- Editing — tap a star to change that performance's rating, or type directly in its note field. Both save immediately.
- Removing — swipe a row left to remove it. It disappears right away and a snackbar offers Undo for a few seconds (the Undo window setting decides how long); undoing restores the exact entry, rating, note and venue tag included.
- Changing the date — press and hold a row's date to open the device's own date/time picker, then Save or Cancel.
- Since no screen-reader gesture maps to a swipe or a long press, the sheet spells both out in an on-screen hint: "Swipe a row left to remove it · press and hold a date to change it."
Removing the very last performance leaves the sheet open rather than closing it, so the Undo snackbar stays reachable.
The star on a song's card, its detail sheet, and its history sheet is not a plain average of what you rated it. It's a confidence-weighted blend: a song's own average is pulled toward the whole list's average, and the pull gets weaker the more times you've actually rated that song. A single lucky 5★ doesn't outrank a solid, many-times-sung streak — but a genuinely strong song with only one or two ratings still isn't punished forever, it needs a bit more history before it's fully trusted.
star = (n · avg + m · C) / (n + m)
-
avg— the song's own average of its rated performances. -
n— how many rated performances count toward that average (each one counts as 1, unless Favour recent form is on). -
C— the list-wide average: every rated performance across every song you own. -
m— Trust a rating after (Settings → Singing & Ratings — "Until then its star leans on your list average."), a choice of 1, 3 (default), or 8 performances. Higher means a song needs more sings before its own average is fully trusted over the list.
If nothing has been rated on the song, or nothing anywhere on your list has been rated yet, no star shows — the detail sheet reads "unsung" or "not rated" instead.
Worked example (list average C = 4.0, default m = 3):
| Performances | Own average | Weighted star |
|---|---|---|
| One 5★ | 5.0 | (1×5 + 3×4) / 4 = 4.25 |
| Ten performances alternating 4★/5★ | 4.5 | (10×4.5 + 3×4) / 13 ≈ 4.38 |
The ten-performance streak (4.38) edges out the single lucky five (4.25), even though its raw average (4.5) is lower — that's the confidence weighting doing its job. It's not an absolute rule, though: on an unusually strong list (C = 4.8), that same lone 5★ scores 4.85, still ahead of the ten-performance 4.5 streak there (4.57) — the weighting narrows a gap toward the list average, it doesn't flip a genuinely higher rating below a lower one.
Favour recent form (Settings → Singing & Ratings — "Fade older performances so current form leads the star. Your logged ratings are untouched.") is off by default. Off, every rated performance counts the same regardless of age. Turned on, older performances count for gradually less — a performance from today counts fully, one from a half-life ago counts half, two half-lives ago a quarter, and so on — so a recent hot streak moves the star faster than an old one did. A "Recent" means dial appears once this is on, offering 1 month, 3 months, 6 months (default), or 1 year as that half-life. Turning this on or off never changes the ratings you actually logged — only how heavily the displayed star weighs each one.
| Screen | What you see |
|---|---|
| My Songs card | The weighted star (red) and your raw Enjoyment rating (blue), side by side |
| Song detail sheet — How it went row | The weighted star plus its number (e.g. 4.5), or "unsung" / "not rated" |
| Song detail sheet — Enjoyment row | Your raw Enjoyment rating, editable right there |
| Performance history subtitle | The weighted star and total performance count |
| Performance history rows | Each performance's own rating, editable per row |
| Venues detail — "avg here" | A plain, unweighted average of the rated performances logged at that venue — not the same number as the weighted star, and calculated separately per venue |
| Venues detail — go-to songs | Each song's plain average at that venue, ranked by average then how often it's been sung there |
| Surprise me — "Favour songs I sing well" | Draws are weighted using the same confidence-weighted star; a song with no rating history draws at the list average, and every song keeps a small floor chance so nothing is ever fully excluded |
A performance is tagged with whichever venue you're checked into at the moment you log it — or with no venue at all if you're not checked into one. It's set once, when you log the sing, and never changes afterward, even if you switch venues or delete the one it was tagged with later. See Venues for how that history rolls up into a venue's performance count, average, and go-to songs.
- My Songs — where "Log performance" lives, and how the card shows both ratings.
- Tonight — checking a song off as the other way to log a performance.
- Venues — per-venue history, go-to songs, and the plain "avg here".
- Surprise me — how "Favour songs I sing well" uses the weighted star.
- Settings reference — every rating-related toggle and dial.