What is FlavourSwitch?
FlavourSwitch is a powerful, lightweight CLI tool that revolutionizes how you manage multiple QuickShell configurations (flavours). Built for Hyprland users who love customizing their desktop experience, it provides instant theme switching with intelligent keybind management and a beautiful interactive panel.
Switch between QuickShell themes in milliseconds, manage unlimited custom themes, and enjoy automatic keybind conflict resolution. All with a self-healing configuration system that detects and fixes issues automatically.
Key Features
Instant Switching
Switch between themes in milliseconds
Theme Management
Support for unlimited custom themes
Interactive Panel
Beautiful GUI panel for theme selection
Keybind Management
Intelligent conflict resolution
Auto-Fix System
Self-healing configuration
Installation
Install FlavourSwitch theme manager
Prerequisites
You need Go and CMake installed:
sudo pacman -S go cmakesudo apt install golang cmakesudo dnf install golang cmakeAutomated Setup (Recommended)
git clone https://github.com/CodewithEvilxd/flavourswitch.git
cd flavourswitch
chmod +x setup.sh
./setup.shThe setup script will automatically install FlavourSwitch and offer to install popular QuickShell themes like Caelestia, Noctalia, DMS, and Illogical Impulse.
Manual Installation
Option 1: CMake Build
mkdir build && cd build
cmake .. && make
sudo make install
flavourswitch exp-setupOption 2: Go Build
go build -o flavourswitch .
sudo cp flavourswitch /usr/local/bin/
sudo cp man/flavourswitch.1 /usr/local/share/man/man1/
# Install completions
sudo cp completions/flavourswitch.bash /usr/share/bash-completion/completions/
sudo cp completions/flavourswitch.zsh /usr/share/zsh/site-functions/
sudo cp completions/flavourswitch.fish /usr/share/fish/vendor_completions.d/
# Install QML interface
sudo mkdir -p /etc/xdg/quickshell/flavourswitch
sudo cp -r quickshell/* /etc/xdg/quickshell/flavourswitch/Option 3: AUR Package (Arch Linux)
yay -S flavourswitch-git
# or
paru -S flavourswitch-gitPost-Installation Setup
flavourswitch exp-setupNote:
This creates configuration directories and integrates with Hyprland.
Usage Guide
Complete guide on how to use FlavourSwitch theme manager
Basic Commands
Cycle to next theme
flavourswitchSwitch to specific theme
flavourswitch apply <theme>Show all themes
flavourswitch listShow active theme
flavourswitch currentOpen theme panel
flavourswitch panelReload keybinds
flavourswitch reloadAdvanced Usage
Force setup (overwrite config)
flavourswitch exp-setup --forceSwitch only keybinds
flavourswitch switch-keybinds <theme>List themes with status
flavourswitch list --statusApply current theme again
flavourswitch apply --currentConfiguration
Config File Location
~/.config/flavourswitch/config.jsonEdit this JSON file to customize theme settings and keybinds.
Pro Tips:
- • Use the interactive panel for easy theme selection
- • Keybinds are automatically managed to avoid conflicts
- • Configuration auto-reloads on changes
- • Supports unlimited custom themes
Advanced Features
Powerful features that make FlavourSwitch stand out
Instant Switching
Switch between QuickShell themes in milliseconds with zero downtime.
Unlimited Themes
Support for unlimited custom themes and flavours with easy management.
Interactive Panel
Beautiful GUI panel for theme selection with live previews.
Smart Keybind Management
Automatic conflict resolution and intelligent keybind switching.
Auto-Fix System
Self-healing configuration that detects and fixes issues automatically.
Type Safe
Written in Go with comprehensive error handling and type safety.
Shell Completions
Full bash, zsh, and fish completion support for faster workflow.
Lightning Fast
Minimal resource usage with instant response times.
QML Interface
Beautiful QML-based panel with smooth animations and theme previews.
Documentation
Complete documentation and resources for FlavourSwitch
GitHub Repository
Source code, issues, and development updates
README
Comprehensive installation and usage guide
Available in the GitHub repository