Appearance
Themes, OLED mode, immersive artwork backgrounds, accent colors, layout presets, and graphics mode.
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 |