Settings reference

Every setting nori keeps, with its default and the clients that list it on their settings screen (“All” is Android, the desktop, the terminal and the iPod). Sound settings are also changed on each client’s equalizer screen, which is not counted here. A client that does not offer a setting uses its default. Applies to nori 0.6.

Between songs

Setting	Default	What it does	Clients
`crossfadeSec`	`0`	Crossfade	All
`autoMix`	`false`	AutoMix: Blends songs like a DJ, matching the beat.	All
`autoMixMaxS`	`12`	Longest mix	All
`autoMixBeatMatch`	`true`	Match the beat: Nudges the next song’s speed so the beats line up.	All
`autoMixMaxTempoPct`	`6`	Biggest speed change	Android, Desktop, Terminal
`autoMixKeepPitch`	`true`	Keep the pitch: Off lets the pitch follow the speed, up to 2 %.	Android, Desktop, Terminal
`autoMixBassSwap`	`true`	Swap the bass: The new song’s bass replaces the old one’s.	Android, Desktop, Terminal
`autoMixFilters`	`true`	Muffle the ending: The outgoing song fades out muffled.	Android, Desktop, Terminal
`autoMixEchoOut`	`true`	Echo out clashes: Overlapping vocals end in an echo instead.	Android, Desktop, Terminal
`autoMixBetterBeats`	`false`	Better beat detection	Android, Desktop, Terminal
`autoMixBeatsMobileData`	`false`	Download over mobile data: Otherwise it waits for Wi-Fi.	Android
`crossfadeKeepAlbums`	`true`	Keep albums gapless: Songs of one album that follow each other in order play without mixing.	All
`crossfadeCurve`	`EQUAL_POWER`	Crossfade curve	Android, Desktop, Terminal
`crossfadeInSec`	`0`	Fade in over	Android, Desktop, Terminal
`crossfadeOutSec`	`0`	Fade out over	Android, Desktop, Terminal
`fadeMs`	`0`	Fade on play and pause	Android, Desktop, Terminal

Controls

Setting	Default	What it does	Clients
`previousAlwaysSkips`	`false`	Previous goes back a song: Instead of restarting the current one.	All
`speed`	`1`	Speed	Android, Desktop, Terminal
`pitch`	`1`	Pitch	Android, Desktop, Terminal
`skipSilence`	`false`	Skip silence	All

Queue

Setting	Default	What it does	Clients
`skipExplicit`	`false`	Skip explicit songs: Songs your server marks explicit.	All
`autoFill`	`true`	Keep playing when the queue ends: Adds more music automatically.	All
`autoFillKind`	`SONGS`	Carry on with	All
`autoFillBasis`	`SIMILAR`	Chosen by	All
`autoFillRemote`	`false`	Include remote songs: Songs not in your library yet, from the server’s streaming providers. Each one played is downloaded into the library.	All
`skipOnError`	`true`	Skip songs that won’t play: Up to three in a row.	All
`bridgeOffline`	`false`	Play downloads when offline: If the server drops, keep playing from downloads.	All

Sound

Setting	Default	What it does	Clients
`eq`	`false`	-	Terminal
`eqMode`	`GRAPHIC`	Graphic on a new install; older installs with a parametric setup keep it ([`load`]).	Terminal
`bassBoostDb`	`0`	Low shelf gain, dB; 0 is off.	Android, Desktop, Terminal
`virtualizer`	`0`	Virtualizer strength, 0 (off) to 1.	Android, Desktop, Terminal
`volumeBoostDb`	`0`	Extra gain, dB, with the limiter behind it; 0 is off.	Android, Desktop, Terminal
`compressor`	`false`	Compressor: Brings quiet passages up and loud ones down, for noisy places or quiet listening.	All
`compThresholdDb`	`-20`	-	Android, Desktop, Terminal
`compRatio`	`3`	-	Android, Desktop, Terminal
`compAttackMs`	`10`	-	Android, Desktop, Terminal
`compReleaseMs`	`180`	-	Android, Desktop, Terminal
`compMakeupDb`	`4.5`	-	Android, Desktop, Terminal
`compKneeDb`	`6`	-	Android, Desktop, Terminal
`expander`	`false`	Noise gate: Turns hiss and hum down further when the music goes quiet. A high ratio closes it like a gate.	Android, Desktop, Terminal
`expThresholdDb`	`-50`	-	Android, Desktop, Terminal
`expRatio`	`2`	-	Android, Desktop, Terminal
`expAttackMs`	`5`	-	Android, Desktop, Terminal
`expReleaseMs`	`150`	-	Android, Desktop, Terminal
`loudness`	`false`	Loudness compensation: As you turn the volume down, brings the bass and the highest notes up the way the ear needs (ISO 226), so quiet listening does not sound thin.	All
`loudnessRefPhon`	`80`	Balanced at, all the way up	Android, Desktop, Terminal
`mono`	`false`	-	Terminal, iPod
`limiter`	`false`	-	Desktop, Terminal, iPod
`eqPreampDb`	`auto`	-	-
`crossfeedDb`	`0`	-	iPod
`crossfeedHz`	`700`	Crossfeed cutoff (bs2b’s `fcut`), Hz.	-
`limiterThresholdDb`	`-1`	-	-
`autoEqAuto`	`false`	AutoEQ for headphones: Applies a known correction curve when headphones connect.	Android, Desktop
`autoEqDownload`	`true`	Keep the AutoEQ list: Downloads the headphone list (850 kB, from github.com) on Wi-Fi, and again once a month, so headphones find their curve.	Android, Desktop
`soundBypass`	`false`	No processing on this output: No equalizer, crossfeed or effects reach this output, and it can use audio offload. Saved with the device’s sound.	Android, Desktop, Terminal
`profilePerOutput`	`true`	Remember sound per device: Each device keeps its own equalizer settings.	Android, Desktop, iPod
`replayGain`	`OFF`	Even out volume	All
`loudnessTarget`	`-18`	Loudness target	All
`gainBoostDb`	`0`	Turn quiet songs up	All
`gainMeasured`	`true`	Measure songs without tags: Songs without tags play at the loudness AutoMix measured, once it has	Android, Desktop, Terminal
`preampDb`	`0`	-	Android, Desktop, Terminal
`untaggedGainDb`	`-6`	Volume for songs without tags	Android, Desktop, Terminal
`hiRes`	`false`	High quality output: Plays 24-bit files in full, and runs the equalizer and effects in floating point. Best on a USB DAC or hi-res output. Starts with the next song.	Android, Desktop, Terminal
`maxRate`	`AUTO`	Highest sample rate	Android, Desktop, Terminal
`bitPerfect`	`false`	Bit perfect USB DAC	Android, Terminal
`offload`	`true`	Save battery while playing	Android, Terminal

Appearance

Setting	Default	What it does	Clients
`theme`	`SYSTEM`	Theme	Android
`hideStatusBar`	`SIDEWAYS`	Hide the status bar	Android
`keepAwake`	`NEVER`	Keep the screen on	Android
`controlsSide`	`DRIVER`	Car screen controls side	Android
`amoled`	`false`	Black background: True black in dark mode. Saves power on OLED screens.	Android, Terminal
`playerColours`	`true`	With AMOLED black, which pages keep their cover colors ([`nori_look::sleeve::page_black`]).	Android
`albumColours`	`false`	-	Android
`artistColours`	`false`	-	Android
`dynamicColor`	`true`	Wallpaper colors: Accent color from your wallpaper.	Android, Terminal
`accent`	theme accent	-	Android, Desktop, Terminal
`coverColors`	`true`	Colors from the cover: Pages take their colors from the artwork, and the tab bar from the page you are on or what is playing.	Android, Desktop, Terminal
`softSleeve`	`true`	Blur the bottom of the cover: The player’s artwork softens into the page.	Android, Terminal
`motionArtwork`	`false`	Moving covers	Android, Terminal
`motionArtworkWifiOnly`	`true`	Motion artwork only on unmetered networks (each is a few MB).	-
`favouriteNotice`	`true`	Confirm favorites: A short message when you favorite or unfavorite something.	Android, Desktop, iPod
`uiScale`	`0`	Text and button size	Android, Terminal
`reduceMotion`	`false`	Less movement: Shorter, simpler animations; long titles stay still.	Android
`einkScreen`	`false`	E-ink screen: Redraws the player only when something changes, for e-ink displays.	Android
`ignoreSystemMotion`	`true`	Animate anyway: Keeps animations on even when the system’s are off.	Android

Lyrics

Setting	Default	What it does	Clients
`lyricsSweep`	`true`	Fill in words as they’re sung: For lyrics timed word by word.	Android, Desktop, Terminal
`lyricsSize`	`1`	Text size	Android
`lyricsTranslation`	`true`	Show translations: When your server has them.	All
`lyricsTimingButton`	`true`	Source and timing: The corner under the lyrics that says where they came from, and nudges them sooner or later when they drift.	Android
`lyricsKeepScreenOn`	`true`	Keep the screen on: While lyrics are shown and music plays.	Android, Terminal
`lyricsOnline`	`true`	Find missing lyrics online: When your server has no timed lyrics. Sends the artist, song and album name to the lyrics sources.	Android, Desktop, Terminal
`lyricsPreferWords`	`true`	Prefer word-by-word lyrics: Keeps looking past lyrics timed line by line.	All
`paxSenixKey`	empty	PaxSenix key	Android, Desktop, Terminal
`betterLyricsKey`	empty	BetterLyrics key	Android, Desktop, Terminal

Library

Setting	Default	What it does	Clients
`tapAction`	`PLAY_LIST`	Choosing a song	Android, Terminal
`swipeRight`	`QUEUE`	Swipe right	Android, Terminal, iPod
`swipeLeft`	`FAVOURITE`	Swipe left	Android, Terminal, iPod
`liveSearchDelayMs`	`350`	Search delay	All
`playlistDescriptions`	`true`	Playlist descriptions: Show a playlist’s description under its name.	Android
`hideImportNotes`	`true`	Hide import notes: Leave out the note the server adds to playlists it imported from a file.	Android
`tasteModel`	`true`	Keep listening history: Stored on this device. Powers mixes and stats.	Android, Desktop, Terminal
`scrobble`	`true`	Tell the server what you play: Sends your plays to your server (scrobbling).	All
`scrobblePercent`	`50`	Count a play after	All
`thirdPartyLookups`	`true`	Look things up online: Missing lyrics (sends the artist, song and album name), the AutoEQ headphone list and moving covers, each with its own switch. Off, nothing is asked.	All
`updateCheck`	`true`	Check automatically: When nori starts, at most once a day, it asks GitHub whether there is a newer release	Android
`updateBeta`	`false`	Beta updates: Also offers test versions of the next release. They may have bugs; turned off, you move to the next stable release when it comes	Android
`remoteControl`	`false`	Control from other devices: Your other devices with nori see and control what plays here, and this one controls them: on the same network directly, elsewhere through octo-fiesta. Off, nothing listens or asks.	All
`jam`	`false`	Jams: Start a Jam from the devices button or a song’s, album’s or playlist’s menu: others join with a link or QR code and ask for songs, and this phone plays them. Needs octo-fiesta.	Android, Desktop, Terminal
`jamAlong`	`true`	Let guests listen along: A Jam’s guests can play its music on their own phones, in step with this one. Each Jam can change it.	Android, Desktop, Terminal

Downloads and storage

Setting	Default	What it does	Clients
`wifi`	`0:`	Quality on Wi-Fi	Android, Desktop, Terminal
`mobile`	`0:`	Quality on mobile data	Android
`download`	`0:`	Quality for downloads	Android, Desktop, Terminal
`parallelDownloads`	`5`	Downloads at once	Android, Desktop, Terminal
`downloadBeats`	`ASK`	ML beats for downloads	Android
`precacheWifi`	`2`	Load ahead on Wi-Fi	Android, Desktop
`precacheMobile`	`1`	Load ahead on mobile data	Android
`coversAhead`	`3`	Load covers ahead	Android, Desktop, Terminal
`cacheMb`	`1024`	Space for streamed music	Android, Desktop, Terminal

Other

Setting	Default	What it does	Clients
`motionArtworkMobile`	`false`	Moving covers on mobile data: Each one is a few megabytes.	Android
`musicFolder`	none	Music folder	Android, Desktop, Terminal
`altMaxBitRate`	`0`	Bitrate limit on the second address	Android, Terminal
`compressorPreset`	`BALANCED`	Strength	Android, Desktop, Terminal
`crossfeedPreset`	`OFF`	-	Terminal
`eqLayout`	`10`	-	Terminal