Skip to main content

Theme System

Sphene Feature

The Theme System allows you to customize Sphene's appearance, including colors, icons, and visual effects to match your preferences.

What It Does​

The Theme System provides:

  • Pre-configured theme presets for quick customization
  • Custom theme creation with full control over colors
  • Theme copying to base new themes on existing ones
  • Button style configurations for UI elements
  • Per-event icon effects and badge settings

When to Use It​

Customize Sphene's appearance for:

  • Personal preference: Match Sphene to your UI theme
  • Visibility: Improve readability with better colors
  • Accessibility: Adjust for color blindness or visual impairments
  • Aesthetics: Create a cohesive look with other plugins

How It Works​

Theme Presets​

Quickly apply pre-configured themes:

  • Default: Sphene's default color scheme
  • Custom: Your own saved themes

Custom Themes​

Create your own themes:

  • Adjust primary and secondary colors
  • Set accent colors for highlights
  • Configure background and text colors
  • Save your custom theme for later use
  • Share themes with other players

Button Styles​

Customize UI button appearance:

  • Normal state colors
  • Hover state colors
  • Click/active state colors
  • Disabled state colors
  • Border and shadow options

Icon Customization​

Configure icon visual effects:

  • Per-event icon colors
  • Badge visibility settings
  • Badge duration configuration
  • Pulse animation settings
  • Event-specific effects

Theme Properties​

You can customize:

  • Primary color: Main UI color
  • Secondary color: Secondary UI elements
  • Accent color: Highlights and important elements
  • Background color: Window and panel backgrounds
  • Text color: All text elements
  • Border color: Borders and separators
  • Success color: Success indicators
  • Warning color: Warning indicators
  • Error color: Error indicators

Configuration​

Access the theme editor:

  1. Open Sphene settings
  2. Navigate to the "Theme" section
  3. Choose a preset or create a custom theme
  4. Adjust colors and settings
  5. Save your theme

Tips​

  • Use the "Copy" feature to base new themes on existing ones
  • Test your theme with different UI elements to ensure readability
  • Save multiple themes for different situations (day/night etc.)
  • Consider color contrast for accessibility