Settings Reference

Settings Reference

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

Orchard Mobile has its own separate settings, documented in Orchard Mobile Settings. Pairing the two through Orchard Connect does not sync preferences between them.

Playback

Setting	Values	Default	Notes
Autoplay	on / off	on	Continue with related tracks when the queue ends
Save queue and current song	on / off	on	Restores queue and position on relaunch
Queue style	Up next / Continuous	Up next	Continuous shows history above the current track
Crossfade	on / off	on	Master switch for both modes
Crossfade mode	Standard / Smart	Standard	See Smart Crossfade
Crossfade length	1 to 12 seconds	8 s	Primary control in Standard mode, a rail in Smart mode
Sleep timer	off / 15 / 30 / 45 / 60 min	off	Also 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

Setting	Values	Default
Interface design	Grove / Canopy	Grove
Graphics mode	Automatic / Integrated GPU	Automatic
Immersive backgrounds	on / off	on
Background intensity	Subtle / Balanced / Vivid	Balanced
Background motion	Animated artwork / Artwork warp	Animated artwork
Accent color	Artwork / Orchard / Custom	Artwork
Theme	Dark / OLED / System	Dark
Custom artist pages	on / off	on

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

Audio Engine

Setting	Range	Default
Engine enabled	on / off	on
Automatic EQ	on / off	off
Manual EQ	on / off	off
Band gains (10 bands)	−12 to +12 dB	0
Preamp	−12 to +6 dB	0 dB
Q	0.4 to 2.4	1.1
Balance	−1 to +1	0
Output device	system devices	default
Volume normalization	on / off	off

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

Song Cache

Setting	Values	Default
Enabled	on / off	on
Maximum size	128 to 4096 MB, in 128 MB steps	512 MB

Full detail in Song Cache.

Integrations

Setting	Values	Default
Discord Rich Presence	on / off	on
Send listening history to YouTube	on / off	on

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

Setting	Values	Default
Close to tray	on / off	off
Beta channel	on / off	off

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.