2
0
Fork 0
mirror of https://github.com/navidrome/navidrome.git synced 2026-02-23 16:49:03 +01:00
🎧☁️ Modern Music Server and Streamer compatible with Subsonic/Airsonic
  • Go 75%
  • JavaScript 19.9%
  • Rust 2.8%
  • Python 1.2%
  • Makefile 0.4%
  • Other 0.6%
Find a file
Deluan Quintão b59eb32961
feat(subsonic): sort search3 results by relevance (#5086)
* fix(subsonic): optimize search3 for high-cardinality FTS queries

Use a two-phase query strategy for FTS5 searches to avoid the
performance penalty of expensive LEFT JOINs (annotation, bookmark,
library) on high-cardinality results like "the".

Phase 1 runs a lightweight query (main table + FTS index only) to get
sorted, paginated rowids. Phase 2 hydrates only those few rowids with
the full JOINs, making them nearly free.

For queries with complex ORDER BY expressions that reference joined
tables (e.g. artist search sorted by play count), the optimization is
skipped and the original single-query approach is used.

* fix(search): update order by clauses to include 'rank' for FTS queries

Signed-off-by: Deluan <deluan@navidrome.org>

* fix(search): reintroduce 'rank' in Phase 2 ORDER BY for FTS queries

Signed-off-by: Deluan <deluan@navidrome.org>

* fix(search): remove 'rank' from ORDER BY in non-FTS queries and adjust two-phase query handling

Signed-off-by: Deluan <deluan@navidrome.org>

* fix(search): update FTS ranking to use bm25 weights and simplify ORDER BY qualification

Signed-off-by: Deluan <deluan@navidrome.org>

* fix(search): refine FTS query handling and improve comments for clarity

Signed-off-by: Deluan <deluan@navidrome.org>

* fix(search): refactor full-text search handling to streamline query strategy selection and improve LIKE fallback logic.

Increase e2e coverage for search3

Signed-off-by: Deluan <deluan@navidrome.org>

* refactor: enhance FTS column definitions and relevance weights

Signed-off-by: Deluan <deluan@navidrome.org>

* fix(search): refactor Search method signatures to remove offset and size parameters, streamline query handling

Signed-off-by: Deluan <deluan@navidrome.org>

* fix(search): allow single-character queries in search strategies and update related tests

Signed-off-by: Deluan <deluan@navidrome.org>

* fix(search): make FTS Phase 1 treat Max=0 as no limit, reorganize tests

FTS Phase 1 unconditionally called Limit(uint64(options.Max)), which
produced LIMIT 0 when Max was zero. This diverged from applyOptions
where Max=0 means no limit. Now Phase 1 mirrors applyOptions: only add
LIMIT/OFFSET when the value is positive. Also moved legacy backend
integration tests from sql_search_fts_test.go to sql_search_like_test.go
and added regression tests for the Max=0 behavior on both backends.

* refactor: simplify callSearch function by removing variadic options and directly using QueryOptions

Signed-off-by: Deluan <deluan@navidrome.org>

* fix(search): implement ftsQueryDegraded function to detect significant content loss in FTS queries

Signed-off-by: Deluan <deluan@navidrome.org>

---------

Signed-off-by: Deluan <deluan@navidrome.org>
2026-02-23 08:51:54 -05:00
.devcontainer feat(scanner): upgrade TagLib to 2.2, with MKA/Matroska support (#5071) 2026-02-21 16:52:48 -05:00
.github feat(server): implement FTS5-based full-text search (#5079) 2026-02-21 17:52:42 -05:00
adapters feat(scanner): upgrade TagLib to 2.2, with MKA/Matroska support (#5071) 2026-02-21 16:52:48 -05:00
cmd refactor: move playlist business logic from repositories to service layer (#5027) 2026-02-21 19:57:13 -05:00
conf feat(server): implement FTS5-based full-text search (#5079) 2026-02-21 17:52:42 -05:00
consts feat(server): implement FTS5-based full-text search (#5079) 2026-02-21 17:52:42 -05:00
contrib build: add packages for deb and rpm to release (#3202) 2024-10-26 13:31:45 -04:00
core refactor: move playlist business logic from repositories to service layer (#5027) 2026-02-21 19:57:13 -05:00
db feat(server): implement FTS5-based full-text search (#5079) 2026-02-21 17:52:42 -05:00
git feat(plugins): experimental support for plugins (#3998) 2025-06-22 20:45:38 -04:00
log refactor: run Go modernize (#5002) 2026-02-08 09:57:30 -05:00
model feat(subsonic): sort search3 results by relevance (#5086) 2026-02-23 08:51:54 -05:00
persistence feat(subsonic): sort search3 results by relevance (#5086) 2026-02-23 08:51:54 -05:00
plugins refactor: run Go modernize 2026-02-09 08:44:44 -05:00
release fix: linux service should restart when upgrading (#5001) 2026-02-09 17:11:45 -05:00
resources fix(ui): update Danish, Portuguese (BR) translations from POEditor (#5039) 2026-02-12 16:38:57 -05:00
scanner refactor: move playlist business logic from repositories to service layer (#5027) 2026-02-21 19:57:13 -05:00
scheduler refactor: run Go modernize (#5002) 2026-02-08 09:57:30 -05:00
server feat(subsonic): sort search3 results by relevance (#5086) 2026-02-23 08:51:54 -05:00
tests feat(subsonic): sort search3 results by relevance (#5086) 2026-02-23 08:51:54 -05:00
ui test(ui): change datagrid from table to div to fix warning 2026-02-21 18:57:12 -05:00
utils refactor: run Go modernize (#5002) 2026-02-08 09:57:30 -05:00
.dockerignore fix: add music.old to .dockerignore and .gitignore 2026-02-06 07:40:05 -05:00
.git-blame-ignore-revs Move project to Navidrome GitHub organization 2021-02-06 21:47:19 -05:00
.gitignore fix: add music.old to .dockerignore and .gitignore 2026-02-06 07:40:05 -05:00
.golangci.yml feat(server): implement FTS5-based full-text search (#5079) 2026-02-21 17:52:42 -05:00
.nvmrc chore(deps): update all dependencies (#4618) 2025-10-25 17:05:16 -04:00
CODE_OF_CONDUCT.md Use Contributor Covenant v2.0 2020-07-21 14:40:21 -04:00
CONTRIBUTING.md docs: update commit message format in CONTRIBUTING.md 2026-02-20 11:00:34 -05:00
Dockerfile feat(server): implement FTS5-based full-text search (#5079) 2026-02-21 17:52:42 -05:00
go.mod chore(deps): update go-taglib to v0.0.0-20260221220301-2fab4903f48e 2026-02-21 17:04:59 -05:00
go.sum chore(deps): update go-taglib to v0.0.0-20260221220301-2fab4903f48e 2026-02-21 17:04:59 -05:00
LICENSE Change license to GPLv3 2020-01-22 14:48:38 -05:00
main.go feat(server): implement FTS5-based full-text search (#5079) 2026-02-21 17:52:42 -05:00
Makefile feat(server): implement FTS5-based full-text search (#5079) 2026-02-21 17:52:42 -05:00
Procfile.dev chore(deps): upgrade to Go 1.24.1 (#3851) 2025-03-17 21:08:10 -04:00
README.md feat: add Navidrome Guru on Gurubase.io (#3491) 2024-11-23 17:29:00 -05:00
reflex.conf feat(server): implement FTS5-based full-text search (#5079) 2026-02-21 17:52:42 -05:00

Navidrome logo

Navidrome Music Server  Tweet

Last Release Build Downloads Docker Pulls Dev Chat Subreddit Contributor Covenant Gurubase

Navidrome is an open source web-based music collection server and streamer. It gives you freedom to listen to your music collection from any browser or mobile device. It's like your personal Spotify!

Note: The master branch may be in an unstable or even broken state during development. Please use releases instead of the master branch in order to get a stable set of binaries.

Check out our Live Demo!

Any feedback is welcome! If you need/want a new feature, find a bug or think of any way to improve Navidrome, please file a GitHub issue or join the discussion in our Subreddit. If you want to contribute to the project in any other way (ui/backend dev, translations, themes), please join the chat in our Discord server.

Installation

See instructions on the project's website

Cloud Hosting

PikaPods has partnered with us to offer you an officially supported, cloud-hosted solution. A share of the revenue helps fund the development of Navidrome at no additional cost for you.

PikaPods

Features

  • Handles very large music collections
  • Streams virtually any audio format available
  • Reads and uses all your beautifully curated metadata
  • Great support for compilations (Various Artists albums) and box sets (multi-disc albums)
  • Multi-user, each user has their own play counts, playlists, favourites, etc...
  • Very low resource usage
  • Multi-platform, runs on macOS, Linux and Windows. Docker images are also provided
  • Ready to use binaries for all major platforms, including Raspberry Pi
  • Automatically monitors your library for changes, importing new files and reloading new metadata
  • Themeable, modern and responsive Web interface based on Material UI
  • Compatible with all Subsonic/Madsonic/Airsonic clients
  • Transcoding on the fly. Can be set per user/player. Opus encoding is supported
  • Translated to various languages

Translations

Navidrome uses POEditor for translations, and we are always looking for more contributors

Documentation

All documentation can be found in the project's website: https://www.navidrome.org/docs. Here are some useful direct links:

Screenshots