How It Works
A guide to the curation system, rating signals, and playlist algorithm.
Rating System
Every recording can be rated using the heart button. Ratings are the core signal for curation and playlist generation.
No Heart — Unrated
Default state. Recording has not been reviewed. Goes into the Curate queue.
Red Heart — Liked
You like this version. It's a good take but not your absolute favourite. Included in playlists with standard weight.
Black Heart — Candidate / Double-Liked
This is a standout recording — a strong candidate for the final cut. Gets double weight in playlist generation. Also queued for stem extraction.
Recording States
Recordings move through lifecycle states that control their visibility and eligibility.
Normal state. Visible in Library, eligible for playlists. All non-deleted recordings.
Explicitly marked as "keep" during curation review. Signifies a finalized, approved recording. Eligible for the Library playlist pool.
Trashed
Soft-deleted. Hidden from normal views but recoverable. Not included in playlists by default — use the Trash filter to include them.
Playlist Generation Algorithm
The playlist is built one track per song. For each song, the algorithm selects the best recording based on the active filters and pool.
Step 1 — Build the Eligible Pool
The filter toggles control which recordings enter the pool for each song. If no filter is active, all active (non-trashed) recordings are eligible.
Trash
Include deleted recordings in the pool.
Library
Include only Kept recordings.
Liked ❤️
Include recordings with at least one red heart.
Candidate 🖤
Include only black heart (double-liked) recordings.
Multiple filters = OR logic. A recording qualifies if it matches any active filter.
Step 2 — Select One Recording Per Song
Within the eligible pool for each song, selection follows this priority:
- 1Collection recordings take priority — if any eligible recording is in your Collection, one is chosen at random from those.
- 2If none are in Collection, a weighted random selection runs: black hearts appear twice (2×), red hearts once (1×). This biases toward stronger recordings.
- 3If no liked recordings exist, any recording in the pool is chosen at random.
Step 3 — Shuffle
The final list of selected tracks is shuffled using the Fisher-Yates algorithm for a truly random playback order.
Genre Filter
Clicking a genre in the Genres tab jumps to the Playlist tab with that genre pre-selected. Only recordings tagged with that genre are eligible for the pool.
You can star genres as favourites — this powers the Analysis tab in the admin Track Queue, which suggests songs that haven't yet been generated in your favourite genres.
Curation Flow
The recommended workflow for reviewing new recordings:
- 1Go to Library → Curate. This shows all unrated, un-kept, non-deleted recordings in chronological order.
- 2Listen, then: Keep (approve), Like (red heart = good), Trash (discard), or double-like for standouts.
- 3Auto-advance plays the next curate track when you take action — so you can review quickly without clicking.
- 4Black heart recordings are flagged in the Stems admin tab for stem extraction.
- 5The Track Queue → Analysis tab uses your ratings to suggest what to generate next.
