Add selectable controller-mode background themes

[Jayian1890]

Summary

• add a new persisted setting (controllerBackgroundTheme) with typed support in shared settings and main-process defaults
• expose theme selection in desktop Settings under Controller Mode and in controller-native System settings (cycle via controller secondary action)
• apply theme-aware XMB wrapper classes and ship three new visual theme variants (nebula, sunset, midnight) while preserving the existing default (aurora) and animation toggle behavior
• thread the new setting through all ControllerLibraryPage callsites to keep overlay and full-page controller views consistent

Why

• controller mode already supports animation on/off, but only one visual background style
• adding multiple curated themes improves personalization and visual variety without changing interaction behavior
• keeping the setting typed and persisted ensures predictable behavior across restarts and controller/desktop navigation surfaces

Implementation details

• Types and persistence
  • add ControllerBackgroundTheme union type and controllerBackgroundTheme field in shared Settings
  • add corresponding field in main settings interface and default to "aurora"
• Desktop settings UI
  • add a settings-select dropdown for selecting the controller background theme in the existing controller-mode subsection
• Controller mode UI logic
  • include backgroundTheme as a System item in ControllerLibraryPage
  • cycle theme values in order: aurora -> nebula -> sunset -> midnight -> aurora
  • compose wrapper class as xmb-theme-* + existing animation state classes
• Styling
  • add theme-specific overrides for .xmb-bg-layer and .xmb-bg-gradient for nebula, sunset, and midnight
  • retain existing aurora visuals as the default style

Test plan

• npm run typecheck in opennow-stable
• open Settings -> Controller Mode and verify theme dropdown updates immediately
• enter controller mode, navigate to Settings > System > Background Theme, and verify cycling works via controller input
• confirm all four themes render distinctly in both controller overlay and full controller library page
• verify Background Animations toggle still independently controls motion across all themes
• restart app and confirm selected theme persists

Risk and compatibility

• low functional risk: change is additive and isolated to settings + controller presentation layers
• no protocol/session behavior changes; stream, input, and session lifecycle logic remain untouched

Made with Cursor

[capy-ai]

Added 1 comment