Design
Music import with AI metadata fill
updated Oct 31, 2026
Plan for #183: bring missing music into the library with full metadata and have Navidrome pick it up.
Where it lives
Not in the player. Finding, downloading, verifying and tagging files is Lyterion's job, and Lyterion already has the pieces:
- files and tags for your own files: lyterion#161
- searching outside the library: lyterion#132
lodesong stays the front door: it already hands songs to Lyterion from add a song (⌘K) and the library doctor (Lyterion guide). This issue is the missing pieces on that path.
What lodesong adds
- Missing artist view. On an artist (or from a list like "Big Roshi, Shyler, TY"), a "find missing" action asks Lyterion for what exists outside the library and shows it next to what you own.
- Metadata fill from the player. For files with thin tags, the doctor offers "fill tags", which hands the file to Lyterion; Lyterion writes the tags (AI only suggests, sources decide) and Navidrome rescans.
- Progress. The add-a-song progress UI is reused: lookup, download, verify, place, play.
Contract needed from Lyterion
| call | purpose |
|---|---|
POST /player/search { artist, title? } | candidates outside the library |
POST /player/fetch { id } | download, verify, tag, place |
POST /player/retag { path } | fill metadata of an owned file |
Same shared token as today (LYTERION_TOKEN). Nothing here works without Lyterion; without it the actions are hidden.
Order
- agree the three calls in Lyterion
- missing-artist action in the player
- doctor "fill tags"