OrchardDocs

Appearance

Themes, OLED mode, immersive artwork backgrounds, accent colors, layout presets, and graphics mode.

All of this lives in Settings → Appearance.

Theme

OptionBehavior
Dark (default)Orchard’s standard dark theme
OLEDTrue-black backgrounds, for OLED panels
SystemFollows your operating system’s light or dark preference

Interface design

Two layout presets:

  • Grove is Orchard’s default layout.
  • Canopy is the alternative arrangement.

Immersive backgrounds

On by default. Immersive backgrounds fill the space behind the player with the current track’s artwork.

Background intensity:

OptionEffect
SubtleLow opacity, minimal distraction
BalancedThe default middle ground
VividStrong, high-contrast artwork presence

Background motion:

OptionEffect
Animated artworkUses animated cover art where a provider has it
Artwork warpSlowly warps the static cover art

Accent color

OptionSource
ArtworkExtracted from the current track’s cover art
OrchardOrchard’s own brand accent
CustomA color you pick

Artwork-derived accents use the Vibrant palette extractor, so the accent tracks what is actually playing.

Graphics mode

Available on Windows and macOS. Linux does not expose this option.

OptionBehavior
Automatic (default)Let the system choose a GPU
Integrated GPUForce the integrated GPU

Forcing the integrated GPU is the fix for laptops where Orchard drives the discrete GPU and burns battery for no visual benefit. Changing this requires restarting Orchard, and the settings panel says so.

Custom artist pages

On by default. When enabled, installed artist packs can replace an artist’s page with custom artwork, layout, and effects. Turning it off returns every artist to the standard page without uninstalling anything. See Artist Packs.

Source map

PathRole
src/app/appearance/appearancePreferences.jsOptions and defaults
src/app/appearance/artworkService.jsArtwork resolution
src/app/appearance/artworkProviders.jsProvider chain, including animated art
src/app/appearance/visualUtils.jsPalette and color math
shared/graphicsMode.jsGraphics mode options
electron/main/graphicsMode.jsApplying graphics mode at launch
src/components/animated-background/Background rendering