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 typeit finds
radiohedRadiohead (typos)
okcomputerOK Computer (missing spaces)
beyonce, sigur rosBeyoncé, Sigur Rós (accents)
acdcAC/DC (punctuation)
daft punk - one more time, one more time by daft punkthat song, with the artist and title split for you
i'm counting the starsthe 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.

filterexample
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:unplayedis: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.