docs/mixes.md

Mixes and playlists made for you

Everything here is made from your library and what you play in lodesong, and saved as ordinary Navidrome playlists, so your phone and every other Subsonic app have them too.

Made for you (home)

whatchanges
daily mix 1–6each starts from an artist you play a lot and takes in the artists you play around the same time (within two hours); about half songs you play, half theirs you rarely or never doevery day at your midnight
discover weekly30 songs you own and never played: most by artists you play (the ones you play most count most), the rest by artists you've never playedevery Friday
daylistwhat you tend to play at this time of day, plus songs by the same artists you haven'tmorning, afternoon, evening, night
release radarsongs added to your library in the last month by artists you play, newest firstas songs arrive
on this daywhat you played around this date a year ago, most played firstevery day
focus mix, late night mix, energy mixwith GROQ_API_KEY: Groq sorts the artists you play into moods once a week (one call, cached), and each mix is a fresh blend of their songs every dayevery day
… · weeklywith GROQ_API_KEY, after Sonaraem: up to five playlists Groq names and fills by grouping the artists you play by shared sound and mood; no artist takes over a listevery week

They need some listening history first (a few days of plays). A card opens its playlist; the play button on a card starts it. Plays are matched to the library by artist and title, so a tagger moving files doesn't lose your history. Songs marked "never in shuffle or radio" are left out.

Playlists from a prompt

New playlist (⌘N, or the + next to playlists) → describe it: "rainy sunday, slow, warm, no vocals", "90s hip hop for a run", "music for focusing". Needs GROQ_API_KEY on the server.

  1. Groq gets your request and a list of your artists: name, how many songs, their years and genres, and how often you play them. It answers with artists from that list, an era if you asked for one, and a size. It never names songs.
  2. The server keeps only artists that are really in your library and builds the list from songs you own, one artist at a time, about half you play and half you don't.
  3. You see the name, how many songs and which artists; again makes another, create saves it.

GROQ_MODEL picks the model (default openai/gpt-oss-120b), GROQ_URL any OpenAI-compatible API instead of Groq.

Recap

Stats → recap: this month or this year as a reel. Minutes listened, your top artist and top song (with the next four), the album on repeat, your sound, when you listen (a morning listener, a night owl), your biggest day, what was new to you, your longest streak, and at the end your top songs, played back or saved as a playlist. ← → or tap the sides to go through it; save image makes a 1080×1920 card to share.

Radio

Start a radio from a song or an artist; 👎 drops a song from that station and keeps its artist away after two.