Skip to content

Ratings and History

Michael Riddle edited this page Jul 28, 2026 · 4 revisions

Ratings & 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.

Two ratings, not one

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.

The star labels

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

Logging a performance

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).

Performance history

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.

Why the star doesn't match your ratings

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

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.

Where each number shows up

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

Venue attribution

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.

See also

  • 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.

Clone this wiki locally