Skip to main content

​
Overview

The theme-selector script provides an interactive graphical menu using Wofi that allows you to quickly switch between available themes. It acts as a user-friendly frontend to the theme-switcher script.
The theme selector is bound to Super + T by default in Hyprland for quick access.

​
How It Works

The script presents a Wofi menu with all available themes and passes your selection to the theme-switcher script:
  1. Displays a list of available themes in a Wofi dmenu
  2. Waits for user selection
  3. Calls theme-switcher with the selected theme
  4. If you press Escape, nothing happens

​
Complete Script

#!/bin/bash

# Definimos la lista de temas disponibles
TEMAS="kanagawa\ngruvbox\ncatppuccin\neverforest"

# Lanzamos Wofi y guardamos la elección del usuario en una variable
ELECCION=$(echo -e "$TEMAS" | wofi --dmenu --prompt "🎨 Elige un tema:" --width 250 --height 350)

# Si el usuario eligió algo (es decir, no pulsó Escape), ejecutamos set-theme
if [ -n "$ELECCION" ]; then
  ~/.local/bin/theme-switcher "$ELECCION"
fi

​
Script Breakdown

​
Available Themes

TEMAS="kanagawa\ngruvbox\ncatppuccin\neverforest"
Defines the list of available themes separated by newlines. These correspond to the theme configurations in your dotfiles.

​
Wofi Menu Display

ELECCION=$(echo -e "$TEMAS" | wofi --dmenu --prompt "🎨 Elige un tema:" --width 250 --height 350)
Parameters:
  • --dmenu: Runs Wofi in dmenu mode for simple list selection
  • --prompt: Sets the prompt text with an emoji icon
  • --width 250: Sets menu width to 250 pixels
  • --height 350: Sets menu height to 350 pixels

​
Theme Application

if [ -n "$ELECCION" ]; then
  ~/.local/bin/theme-switcher "$ELECCION"
fi
Only executes the theme switcher if a selection was made (not empty string). This prevents errors when pressing Escape.

​
Usage Examples

​
From Terminal

# Run the theme selector
theme-selector

​
From Hyprland

The default keybinding is already configured: 
bind = SUPER, T, exec, theme-selector
Press Super + T to open the theme selector menu.

​
Integration with Theme Switcher

The theme selector is a lightweight wrapper around the theme-switcher script. When you select a theme:
1

User selects theme

You choose a theme from the Wofi menu
2

Script validates selection

Checks that selection is not empty
3

Calls theme-switcher

Passes the selected theme name to theme-switcher
4

Theme applies

All components update to the new theme

​
Customization

​
Adding New Themes

To add a new theme to the selector:
  1. Add the theme configuration files (see Theme Customization)
  2. Update the TEMAS variable:
TEMAS="kanagawa\ngruvbox\ncatppuccin\neverforest\ntokyonight"

​
Changing Menu Appearance

Modify the Wofi parameters: 
# Larger menu
ELECCION=$(echo -e "$TEMAS" | wofi --dmenu --prompt "🎨 Theme:" --width 400 --height 500)

# Different prompt
ELECCION=$(echo -e "$TEMAS" | wofi --dmenu --prompt "Select Theme" --width 250 --height 350)

​
Using a Different Menu

Replace Wofi with Rofi or another dmenu alternative: 
# Using Rofi
ELECCION=$(echo -e "$TEMAS" | rofi -dmenu -p "🎨 Elige un tema:")

# Using dmenu
ELECCION=$(echo -e "$TEMAS" | dmenu -p "🎨 Elige un tema:")

​
Troubleshooting

Check if Wofi is installed:
which wofi
Install if missing:
sudo pacman -S wofi
Verify the theme-switcher script is executable and in your PATH:
ls -la ~/.local/bin/theme-switcher
Make it executable if needed:
chmod +x ~/.local/bin/theme-switcher
Make sure you added it to the TEMAS variable in the script:
nano ~/.local/bin/theme-selector
Add your theme to the list with \n separators.

Theme Switcher

The backend script that applies theme changes

Custom Scripts

Learn how to create your own scripts

Build docs developers (and LLMs) love

Get started for freeTalk to us