docs/search.md
Search
⌘K (or /) opens search from anywhere; ↵ on a result plays it, ⌘↵ opens the full results page.
keep music searches its own index on the server (SQLite FTS5 over your whole library and its lyrics), not Navidrome's search, so it forgives what Navidrome's doesn't:
| you type | it finds |
|---|---|
radiohed | Radiohead (typos) |
okcomputer | OK Computer (missing spaces) |
beyonce, sigur ros | Beyoncé, Sigur Rós (accents) |
acdc | AC/DC (punctuation) |
daft punk - one more time, one more time by daft punk | that song, with the artist and title split for you |
i'm counting the stars | the song with that line, and playing it starts at that line |
Results are grouped (top result, songs, albums, artists, lyrics) and ranked: exact title or artist first, then prefix, word and fuzzy matches. Within those, songs you like and play often come first. A lyrics match never outranks a song whose title matches.
Filters
Add these to any search; each shows as a chip you can remove.
| filter | example |
|---|---|
artist: | artist:"massive attack" |
album: | album:mezzanine |
genre: | genre:trip-hop |
year: | year:1998, year:1990..1999, year:..1980 |
format: | format:flac |
is:liked, is:unplayed | is:liked year:2020.. |
lyrics: | lyrics: counting the stars (only lyrics; the rest of the text is the phrase) |
Filters alone work too: genre:jazz year:1950..1965 lists the most played matches.
Search inside a list
⌘F on an album, playlist, liked songs, the queue or any song list filters that list in place.
The index
The server builds it as one account (INDEX_USER/INDEX_PASSWORD, else the admin who signed in most recently),
syncs after every Navidrome scan and once a day, and only ever returns what the person searching may see (music
folders per user). Admins: user menu → library index shows the counts and a "rebuild now" button. Lyrics become
searchable as they're fetched (lyrics); search says how many are indexed so far.