Introducing the Theme Switcher Plugin
The Theme Switcher plugin offers an easy way to browse and apply themes on your platform. With its intuitive carousel interface, users can quickly choose from a variety of themes and customize their experience with just a click.
Simple Setup
To get started, enable the plugin from the Settings menu under Plugins. Once activated, you can enhance your environment by adding a Theme Switcher bar widget or create a shortcut from the control center. Additionally, you can execute a command to toggle the carousel: noctalia msg panel-toggle theblackdon/theme-switcher:carousel.
Applying Themes
The carousel displays different theme cards, each equipped with a palette, wallpaper, preview image, and title. Clicking on a theme card will apply the associated palette, wallpaper, and templates instantly. You can also edit existing themes or add new ones using the pencil and plus buttons, respectively.
Editing Themes
Editing a theme is straightforward. The editor allows you to select a palette source—options include built-in palettes, wallpapers, community contributions, or custom selections. You can also choose wallpapers, capture a screenshot, and provide a title. The Browse button makes it easy to upload multiple wallpapers at once by opening a multi-select picker.
Wallpaper Management
A dedicated wallpaper shortcut allows you to access the wallpapers panel, making it simple to browse and switch wallpapers for the applied theme without needing to re-apply the palette. The Add Wallpaper button opens a user-friendly thumbnail picker that supports pagination, name filters, and selection options. This ensures smooth browsing even with extensive image collections.
Random Wallpaper Feature
For those who enjoy a bit of spontaneity, the random shortcut enables users to apply a randomly selected wallpaper from the currently active theme with just a single click.
Keyboard Shortcuts
For efficiency, wallpaper switching can also be executed via keyboard shortcuts using the wallpaper-ipc service. This allows commands for random, next, and apply to be bound to user-defined keys. Simple commands like :wallpaper-ipc allow for immediate wallpaper changes while ensuring that functionality is versatile and accessible.
How Themes Are Applied
When applying a chosen theme, the active wallpaper is set first. This is followed by executing a command to switch the palette, ensuring that templates are re-rendered to match the new theme. Each theme can include multiple wallpapers, and users can select their preferred image from the wallpapers panel.
Final Notes
- Community-generated palettes can be accessed through an HTTP catalog, with a backup option using cached versions.
- Custom palettes are stored in the user's configuration folder.
- The plugin saves all themes within its data directory.
- Thumbnail previews are generated in the background using various tools, ensuring smooth performance even when handling large libraries of wallpapers.
