OrchardDocs

Settings Reference

Every setting in Orchard with its accepted values and default, from playback and appearance to the audio engine and song cache.

Every option in Orchard’s settings, in the order the settings page presents them.

Playback

SettingValuesDefaultNotes
Autoplayon / offonContinue with related tracks when the queue ends
Save queue and current songon / offonRestores queue and position on relaunch
Queue styleUp next / ContinuousUp nextContinuous shows history above the current track
Crossfadeon / offonMaster switch for both modes
Crossfade modeStandard / SmartStandardSee Smart Crossfade
Crossfade length1 to 12 seconds8 sPrimary control in Standard mode, a rail in Smart mode
Sleep timeroff / 15 / 30 / 45 / 60 minoffAlso supports stopping at end of track

Volume, shuffle, and repeat are controlled from the player and persist across sessions. Defaults are volume 0.85, shuffle off, repeat off.

Appearance

SettingValuesDefault
Interface designGrove / CanopyGrove
Graphics modeAutomatic / Integrated GPUAutomatic
Immersive backgroundson / offon
Background intensitySubtle / Balanced / VividBalanced
Background motionAnimated artwork / Artwork warpAnimated artwork
Accent colorArtwork / Orchard / CustomArtwork
ThemeDark / OLED / SystemDark
Custom artist pageson / offon

Graphics mode appears only on Windows and macOS, and requires a restart to take effect. Full detail in Appearance.

Audio Engine

SettingRangeDefault
Engine enabledon / offon
Automatic EQon / offoff
Manual EQon / offoff
Band gains (10 bands)−12 to +12 dB0
Preamp−12 to +6 dB0 dB
Q0.4 to 2.41.1
Balance−1 to +10
Output devicesystem devicesdefault
Volume normalizationon / offoff

Automatic EQ and manual EQ are mutually exclusive. Profiles can be exported and imported. Full detail in Audio Engine.

Song Cache

SettingValuesDefault
Enabledon / offon
Maximum size128 to 4096 MB, in 128 MB steps512 MB

Full detail in Song Cache.

Integrations

SettingValuesDefault
Discord Rich Presenceon / offon
Send listening history to YouTubeon / offon

Last.fm, Spotify, and the Orchard account have their own settings sections. Full detail in Integrations.

Orchard Connect

Pairing QR code and link, pending pairing requests awaiting your approval, and the list of paired devices with the option to revoke any of them. Full detail in Orchard Connect.

Artist Packs

Import a user pack, view installed packs, and remove them. Full detail in Artist Packs.

Last.fm

Authorize or disconnect your Last.fm account, and see current scrobbling status.

Spotify

Connect or disconnect a Spotify account.

Orchard Account

Manages the identity used by the Support System and cloud analysis sync.

Setup

A checklist of what is configured and what is not: sign-in, integrations, connected devices, and the like. It reports “Setup complete” once nothing is outstanding.

Backup

Export data writes your Orchard state to a file. Restore data reads one back. This covers preferences, queue state, audio profiles, Replay events, and pins.

Use this before reinstalling, moving machines, or experimenting with settings you might want to undo.

Diagnostics

Reports Orchard’s runtime state: version, platform, native addon status, service reachability, and recent errors. Attach this to a support report when something is broken.

Application

SettingValuesDefault
Close to trayon / offoff
Beta channelon / offoff

Close to tray off means closing the window quits Orchard.

Beta channel opts into prerelease builds through the updater. See Releases and Updates.

Where settings are stored

Renderer preferences live in local storage inside Orchard’s per-user data directory. Main-process state (session state, graphics mode, paired devices) lives as JSON files in the same directory. Paths are listed in Getting Started.