Themes Plugin
Pre-defined and custom themes with background and accent controls
Themes Plugin
The Themes plugin provides pre-defined visual themes and a comprehensive custom theme builder. It controls background imagery, accent lines, icons, and preview assets, and can disable conflicting plugins (e.g., Background) when active.
Quick Start
- Go to Settings → Plugins
- Enable "Themes"
- Click "Open" to configure
- Choose between Pre-defined or Custom themes
Pre-defined Themes
The Pre-defined section includes official themes and your custom exported themes:
Official Themes
- Nightshift: A teal-accented cyberpunk theme with elegant UI elements
- Bloodmoon: A dark theme with black-red gradients and crimson accents
- Tea: A cozy beige theme created for the YouTuber and Twitch streamer Snipztea
- Arcane: A sleek dark theme with elegant pink-red glow effects inspired by the Arcane aesthetic
Arcane Theme - Accent Color Customization
The Arcane theme features a unique accent color customization option. You can change the glow and accent colors to match your preference:
Predefined Colors:
- Purple, Pink/Red (default), Orange, Yellow, Green, Teal, Blue
Custom Colors:
- Click the "+" button to open the color picker
- Use the color picker to select any custom color
- Custom colors are saved and appear alongside predefined colors
The accent color affects:
- Background glow effects
- Primary and accent UI elements
- Button highlights and interactive elements
Using Pre-defined Themes
- Select the Pre-defined tab
- Choose a theme from the grid
- Click "Activate" to apply the theme
- Click "Deactivate" to return to default
Custom Exported Themes
Custom themes you've exported appear in the Pre-defined section with additional options:
- Edit: Modify the theme settings
- Delete: Remove the custom theme (only for user-created themes)
- Activate/Deactivate: Same as official themes
Note: Official themes (Nightshift, Bloodmoon, Tea, Arcane) cannot be deleted.
Custom Theme Builder
Switch to the Custom tab to create your own themes:
Theme Components
- Accent Line Color: Choose the color for UI accent lines
- Theme Icon: Upload a custom icon displayed in the top-left corner
- Background Image: Set via URL or upload local file
- Background Opacity: Control transparency (0-100%)
Background Options
- URL Source: Enter direct image URL
- Local Upload: Choose image from your computer
- Opacity Control: Adjust background transparency with slider
Export to Pre-defined
Export your custom theme to make it permanent:
- Configure your theme settings
- Click "Export to Pre-defined"
- Fill in the export dialog:
- Name: Theme name
- Description: Theme description
- Sub Description: Additional details
- Preview Image: Upload preview image (optional)
- Click "Save" to add to Pre-defined themes
Theme Management
Editing Custom Themes
- Custom themes in Pre-defined section can be edited
- Click "Edit" to modify settings
- Changes are applied immediately
- Use "Save" or "Cancel" to confirm changes
Deleting Themes
- Only user-created themes can be deleted
- Official themes (Nightshift, Bloodmoon, Tea, Arcane) are permanent
- Deleted themes cannot be recovered
Tips
- Background-heavy themes work best with lower opacity (20-40%)
- Use high-resolution images for large displays
- Optimize file sizes for better performance
- Preview images help identify themes quickly
- When Themes is active, Background plugin may be disabled
Troubleshooting
Theme Not Applying - Ensure plugin is enabled - Check if Background plugin conflicts - Verify theme settings are saved - Try switching between themes
Background Not Visible - Check opacity settings - Verify image URL is accessible - Try uploading local image instead - Ensure image format is supported
Export Issues - Verify theme name is not empty - Check image file size limits - Ensure all required fields are filled - Try different image formats
Learn More
- Developer documentation: Click Here