hub / github.com/navidrome/navidrome

github.com/navidrome/navidrome @v0.62.0

repository ↗ · DeepWiki ↗ · release v0.62.0 ↗ · Ask this repo → · + Follow

6,825 symbols 24,968 edges 1,255 files 2,195 documented · 32% 60 cross-repo links ● updated todayv0.62.0 · 2026-06-08★ 22,104112 open issues

README

Navidrome Music Server

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.

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

<img height="550" src="https://raw.githubusercontent.com/navidrome/navidrome/master/.github/screenshots/ss-mobile-login.png">
<img height="550" src="https://raw.githubusercontent.com/navidrome/navidrome/master/.github/screenshots/ss-mobile-player.png">
<img height="550" src="https://raw.githubusercontent.com/navidrome/navidrome/master/.github/screenshots/ss-mobile-album-view.png">
<img width="550" src="https://raw.githubusercontent.com/navidrome/navidrome/master/.github/screenshots/ss-desktop-player.png">

Extension points exported contracts — how you extend this code

Item (Interface)

Item represents an item that can be cached. It must implement the Key method that returns a unique key for a given item. [9 …

utils/cache/file_caches.go

User (Interface)

User provides business logic for user management with plugin coordination. [6 implementers]

core/user.go

AlbumInfoRetriever (Interface)

AlbumInfoRetriever provides album info (no images) [8 implementers]

core/agents/interfaces.go

Scrobbler (Interface)

Scrobbler provides scrobbling functionality to external services. This capability allows plugins to submit listening his [7 …

plugins/capabilities/scrobbler.go

ArtistMBIDProvider (Interface)

ArtistMBIDProvider provides the GetArtistMBID function. [7 implementers]

plugins/pdk/go/metadata/metadata_stub.go

Lyrics (Interface)

Lyrics can fetch lyrics for a media file. [5 implementers]

core/lyrics/lyrics.go

Scrobbler (Interface)

(no doc) [7 implementers]

core/scrobbler/interfaces.go

ShareRepository (Interface)

(no doc) [8 implementers]

model/share.go

Core symbols most depended-on inside this repo

Join

called by 532

model/participants.go

core/playback/device.go

core/playback/device.go

Set

called by 245

plugins/host/kvstore.go

WithUser

called by 234

model/request/request.go

Shape

Function 2,824

Method 2,650

Struct 1,009

Interface 172

TypeAlias 93

Class 41

Route 23

FuncType 13

Languages

Go88%

TypeScript9%

Python3%

Modules by API surface

server/subsonic/responses/responses.go81 symbols

scanner/metadata_old/metadata.go65 symbols

plugins/cmd/ndpgen/internal/types.go64 symbols

model/criteria/operators.go62 symbols

plugins/pdk/go/metadata/metadata.go55 symbols

core/ffmpeg/ffmpeg.go50 symbols

plugins/cmd/ndpgen/internal/generator.go49 symbols

model/metadata/metadata.go49 symbols

model/mediafile.go45 symbols

core/playlists/playlists.go45 symbols

conf/configuration.go45 symbols

plugins/pdk/go/metadata/metadata_stub.go44 symbols

Dependencies from manifests, versioned

dario.cat/mergov1.0.2 · 1×

github.com/Masterminds/semver/v3v3.5.0 · 1×

github.com/Masterminds/squirrelv1.5.4 · 1×

github.com/andybalholm/cascadiav1.3.3 · 1×

github.com/atombender/go-jsonschemav0.20.0 · 1×

github.com/aymerick/douceurv0.2.0 · 1×

github.com/beorn7/perksv1.0.1 · 1×

github.com/bmatcuk/doublestar/v4v4.10.0 · 1×

github.com/cespare/reflexv0.3.1 · 1×

github.com/cespare/xxhash/v2v2.3.0 · 1×

github.com/creack/ptyv1.1.24 · 1×

github.com/davecgh/go-spewv1.1.2-0.20180830191 · 1×

For agents

$ claude mcp add navidrome \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact