Configuration on Navidrome

Navidrome Configuration Options

Fri, 06 Jan 2017 00:00:00 +0000

Navidrome allows some customization using environment variables, loading from a configuration file or using command line arguments.

Configuration File

Some options are only configurable using a configuration file. If you are using environment variables (ex: with Docker), you may not be able to set all options.

If you want to use a configuration file with Docker, you can do so by creating a navidrome.toml config file in the host folder that is mapped to your /data volume. Docker installations automatically look for a navidrome.toml file in the /data folder.

Using custom tags with Navidrome

Mon, 02 Jan 2017 00:00:00 +0000

Overview

As all tags imported are stored and indexed in the database, to improve performance and reduce storage requirements, Navidrome only imports a predefined set of tags. The complete list of default tags imported are listed here.

However, Navidrome supports importing and using custom tags from your music files. Custom tags allow you to extend the metadata beyond the default supported tags. This functionality can be configured via the configuration file.

Customizing Persistent IDs in Navidrome

Mon, 02 Jan 2017 00:00:00 +0000

Persistent IDs in Navidrome

Persistent IDs (PIDs) are configurable identifiers introduced to provide stable references for Tracks and Albums in Navidrome, significantly improving how media is managed and identified.

Overview of Persistent IDs

Persistent IDs are unique, user-configurable identifiers for tracks and albums, enabling Navidrome to accurately detect and manage moved or re-tagged files, and disambiguate albums with identical names or duplicated entries.

Key Features

Configurable and Flexible: Users can define their PID structure using various tags, including musicbrainz_trackid, albumid, discnumber, tracknumber, title, folder, albumartistid, catalognum, Discogs IDs, or even custom tags
Accurate File Detection: Navidrome recognizes moved or re-tagged files, preventing duplication or mismatches.
Album Disambiguation: Easily differentiate albums with identical names through custom tags like albumversion (e.g., Deluxe Editions).

Default Configuration

The default configuration prioritizes MusicBrainz IDs (MBIDs) when available: