Skip to content

Appearance

SFG545 edited this page Aug 12, 2026 · 1 revision

Appearance

All of this lives in Settings → Appearance.

Theme

Option Behavior
Dark (default) Orchard's standard dark theme
OLED True-black backgrounds, for OLED panels
System Follows 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:

Option Effect
Subtle Low opacity, minimal distraction
Balanced The default middle ground
Vivid Strong, high-contrast artwork presence

Background motion:

Option Effect
Animated artwork Uses animated cover art where a provider has it
Artwork warp Slowly warps the static cover art

Accent color

Option Source
Artwork Extracted from the current track's cover art
Orchard Orchard's own brand accent
Custom A 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.

Option Behavior
Automatic (default) Let the system choose a GPU
Integrated GPU Force 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

Path Role
src/app/appearance/appearancePreferences.js Options and defaults
src/app/appearance/artworkService.js Artwork resolution
src/app/appearance/artworkProviders.js Provider chain, including animated art
src/app/appearance/visualUtils.js Palette and color math
shared/graphicsMode.js Graphics mode options
electron/main/graphicsMode.js Applying graphics mode at launch
src/components/animated-background/ Background rendering

Clone this wiki locally