Settings

Settings

Everything is configured on the Settings page, and most of it can also be set with environment variables.

Environment variables vs. the Settings page

Environment variables only seed the settings the first time naviList starts. After that, whatever you save on the Settings page wins. If you change an environment variable later and nothing happens, that's why: change it on the Settings page instead.

A few variables are read every time and are not settings: PORT, LOG_LEVEL, DB_PATH and DATA_DIR. TZ isn't a naviList setting either, but it controls the timezone scheduled playlist refreshes run on. See Auto-Refresh.

Variable	Default	What it does
PORT	3000	Port naviList listens on
LOG_LEVEL	info	debug, info, warn or error
DB_PATH	/app/data/navilist.db	Where the SQLite database lives
NAVIDROME_URL		Navidrome address, e.g. http://navidrome:4533
NAVIDROME_USER		Navidrome username
NAVIDROME_PASSWORD		Navidrome password
MUSIC_FOLDER_IDS		Comma-separated music folder IDs to limit the sync to
LASTFM_API_KEY		Last.fm API key
LASTFM_USERNAME		Last.fm username
LISTENBRAINZ_TOKEN		ListenBrainz user token
LISTENBRAINZ_USERNAME		ListenBrainz username
MALOJA_URL		Maloja address, e.g. http://maloja:42010
MALOJA_API_KEY		Maloja API key
LIDARR_URL		Lidarr address, e.g. http://lidarr:8686
LIDARR_API_KEY		Lidarr API key
LIDARR_ROOT_FOLDER		Lidarr root folder, e.g. /music
LIDARR_QUALITY_PROFILE_ID		Lidarr quality profile ID
LIDARR_METADATA_PROFILE_ID		Lidarr metadata profile ID
NL_NSP_PATH		Folder inside the container where .nsp files are written

The Settings page, section by section

Navidrome

URL, username and password for your Navidrome server. Test Connection checks them. Load Folders lists your music folders so you can pick which ones naviList should sync. Leave them all unticked to use everything.

Library

Fetch artist images from Deezer during library sync downloads artist pictures for the library browser. It's the only thing naviList asks Deezer for. Turn it off if you'd rather not make those requests.

NSP Playlists

Output path is the folder inside the naviList container where .nsp files are written. It has to be a folder Navidrome can also see, set as Navidrome's PlaylistsPath. See Navidrome Smart Playlists.

Imports

Fuzzy match threshold (0 to 100, default 80) is the minimum confidence for a close match to be offered when you import a playlist. Higher means fewer, more accurate suggestions. See Importing Playlists.

Last.fm, ListenBrainz, Maloja

Credentials for each service. See Integrations for what each one does and which features need which.

Lidarr

URL, API key, root folder, quality profile and metadata profile. Connect loads the profiles from Lidarr so you can pick them. Auto-add turns on automatic sending of missing artists. See Integrations.

Click Save Settings when you're done.