Repository navigation
v0.2.0 — star ratings, and a shuffle that prefers them
Star ratings, 1–5, and a third shuffle state that weights the order towards them.
Ratings are set from the strip under the track title, the number keys (1–5 rate, 0 clears), or a right-click on any row — that last one because clicking a row in this player starts it, so without a menu you could only rate a track by playing it first.
They live in ~/.config/gapless/ratings.json, keyed by absolute path, and are never written into your audio files: rating a song would mean rewriting it, and POPM has no agreed 1–5-to-0–255 mapping, so a value read back only means something if you already know which player wrote it.
Favorites shuffle is an ordering, not a filter — every track still plays exactly once per pass, but the order is drawn with higher-rated tracks weighted towards the front. Weights double per star; unrated sits level with 2★, because "I have not judged this" is not "I do not like this".
Measured over 4,000 passes of a 12-track queue, where a plain shuffle puts every track at a mean slot of 5.50:
5-star 1.51 unrated 5.96 1-star 7.65
Also: state.json gains shuffle_mode, and MPRIS can no longer silently demote favorites shuffle to a plain one.
No AppImage on this release — it was superseded the same day by v0.3.0, which carries the build. See the full notes in CHANGELOG.md.