Theme Switcher - Kanagawa Dotfiles

Overview

The theme-switcher script is the core theme management system for Kanagawa dotfiles. It updates configuration files for every component in your system and reloads services to apply changes instantly.

This script updates Hyprland, Waybar, Wofi, Ghostty, Neovim, VSCodium, SwayNC, Wlogout, btop, Cava, and wallpapers.

How It Works

The theme switcher follows a systematic approach:

Validates the theme name
Updates configuration files for each component
Maps theme names to component-specific theme names
Reloads services to apply changes
Selects wallpaper matching the theme
Sends notification when complete

Complete Script

#!/bin/bash

# ==========================================
# ArchAI Theme Switcher
# ==========================================

THEME=$1

# Verificar que se ha introducido un tema
if [ -z "$THEME" ]; then
  echo "❌ Error: No has especificado ningún tema."
  echo "💡 Uso: set-theme <kanagawa|gruvbox|catppuccin>"
  exit 1
fi

echo "🎨 Aplicando el tema: $THEME..."

# --- 1. WAYBAR & WOFI (CSS) ---
echo "@import url(\"$HOME/.config/wofi/colors/custom/$THEME.css\");" >"$HOME/.config/wofi/colors/colors.css"
echo "@import url(\"$HOME/.config/waybar/colors/custom/$THEME.css\");" >"$HOME/.config/waybar/colors/colors.css"

# --- 2. HYPRLAND (CONF) ---
echo "source = ~/.config/hypr/colors/custom/$THEME.conf" >"$HOME/.config/hypr/colors/colors.conf"

# --- 3. GHOSTTY (INI) ---
echo "config-file = custom/$THEME" >"$HOME/.config/ghostty/colors/colors"

# --- MAPEO DE TEMAS ---
case $THEME in
kanagawa)
  VSCODIUM_THEME="Kanagawa Wave"
  NVIM_THEME="kanagawa"
  NOTIFY_ICON="🌊"
  ;;
gruvbox)
  VSCODIUM_THEME="Gruvbox Dark Hard"
  NVIM_THEME="gruvbox"
  NOTIFY_ICON="📦"
  ;;
catppuccin)
  VSCODIUM_THEME="Catppuccin Mocha"
  NVIM_THEME="catppuccin"
  NOTIFY_ICON="☕"
  ;;
everforest)
  VSCODIUM_THEME="Everforest Night Hard"
  NVIM_THEME="everforest"
  NOTIFY_ICON="🌲"
  ;;
*)
  echo "❌ Error: Tema no reconocido."
  exit 1
  ;;
esac

# --- 4. VSCODIUM (JSON) ---
VSCODIUM_SETTINGS="$HOME/.config/VSCodium/User/settings.json"

if [ -f "$VSCODIUM_SETTINGS" ]; then
  sed -i -E "s/\"workbench.colorTheme\": \".*/\"workbench.colorTheme\": \"$VSCODIUM_THEME\"/g" "$VSCODIUM_SETTINGS"
  echo "⚙️  Tema de VSCodium actualizado a $VSCODIUM_THEME"
else
  echo "⚠️  No se encontró settings.json de VSCodium. Saltando..."
fi

# --- 5. NEOVIM (LUA PARA LAZYVIM) ---
mkdir -p "$HOME/.config/nvim/lua"
echo "return '$NVIM_THEME'" >"$HOME/.config/nvim/lua/theme_bridge.lua"

# --- 6. SWAYNC ---
echo "@import \"custom/$THEME.css\";" >"$HOME/.config/swaync/colors/colors.css"

# --- 7. WLOGOUT ---
echo "@import \"custom/$THEME.css\";" >"$HOME/.config/wlogout/colors/colors.css"

# --- 10. BTOP ---
ln -sf "$HOME/.config/btop/themes/custom/$THEME.theme" "$HOME/.config/btop/themes/colors.theme"

# --- 10. CAVA ---
ln -sf "$HOME/.config/cava/themes/custom/$THEME" "$HOME/.config/cava/themes/colors"

# Le pedimos a SwayNC que recargue su CSS en vivo
swaync-client -rs

# 1. Recargar los bordes de Hyprland
hyprctl reload &>/dev/null

# 2. Reiniciar Waybar
killall waybar &>/dev/null
waybar &>/dev/null &
disown

# 3. Forzar el Hot-Reload de Ghostty
killall -SIGUSR2 ghostty

# --- 7. HYPRPAPER (FONDO DINÁMICO CON WOFI) ---
WALLPAPER_DIR="$HOME/.config/hypr/wallpapers"

AVAILABLE_WALLPAPERS=$(find "$WALLPAPER_DIR" -maxdepth 1 -type f -iname "${THEME}*" | sort)

if [ -n "$AVAILABLE_WALLPAPERS" ]; then
  COUNT=$(echo "$AVAILABLE_WALLPAPERS" | wc -l)

  if [ "$COUNT" -eq 1 ]; then
    SELECTED_WALLPAPER="$AVAILABLE_WALLPAPERS"
  else
    BASENAMES=$(echo "$AVAILABLE_WALLPAPERS" | xargs -n 1 basename)
    CHOICE=$(echo "$BASENAMES" | wofi --dmenu --prompt "🖼️ Elige fondo para $THEME:")

    if [ -n "$CHOICE" ]; then
      SELECTED_WALLPAPER="$WALLPAPER_DIR/$CHOICE"
    else
      SELECTED_WALLPAPER=$(echo "$AVAILABLE_WALLPAPERS" | head -n 1)
    fi
  fi

  hyprctl hyprpaper preload "$SELECTED_WALLPAPER" >/dev/null
  hyprctl hyprpaper wallpaper ",$SELECTED_WALLPAPER" >/dev/null
  hyprctl hyprpaper unload all >/dev/null

  echo "🖼️ Fondo de pantalla actualizado: $SELECTED_WALLPAPER"
else
  echo "⚠️ No se encontraron fondos para el tema $THEME en $WALLPAPER_DIR"
fi

# --- 8. NOTIFICACIÓN FINAL ---
notify-send "$NOTIFY_ICON Tema aplicado" "El entorno ahora usa $THEME" -t 2000 -a "Theme Switcher"

Script Breakdown

1. Input Validation

THEME=$1

if [ -z "$THEME" ]; then
  echo "❌ Error: No has especificado ningún tema."
  echo "💡 Uso: set-theme <kanagawa|gruvbox|catppuccin>"
  exit 1
fi

Validates that a theme name was provided as an argument.

2. CSS Updates (Waybar & Wofi)

echo "@import url(\"$HOME/.config/wofi/colors/custom/$THEME.css\");" >"$HOME/.config/wofi/colors/colors.css"
echo "@import url(\"$HOME/.config/waybar/colors/custom/$THEME.css\");" >"$HOME/.config/waybar/colors/colors.css"

Why absolute paths? Using $HOME ensures GTK3 applications can always find the CSS files, regardless of working directory.

3. Hyprland Configuration

echo "source = ~/.config/hypr/colors/custom/$THEME.conf" >"$HOME/.config/hypr/colors/colors.conf"

Updates the Hyprland color configuration to source the selected theme.

4. Ghostty Configuration

echo "config-file = custom/$THEME" >"$HOME/.config/ghostty/colors/colors"

Sets the Ghostty terminal theme configuration file.

5. Theme Name Mapping

case $THEME in
kanagawa)
  VSCODIUM_THEME="Kanagawa Wave"
  NVIM_THEME="kanagawa"
  NOTIFY_ICON="🌊"
  ;;
gruvbox)
  VSCODIUM_THEME="Gruvbox Dark Hard"
  NVIM_THEME="gruvbox"
  NOTIFY_ICON="📦"
  ;;
# ... more themes
esac

This mapping translates short theme names (like kanagawa) to the exact names used by VSCodium extensions and Neovim plugins.

6. VSCodium JSON Update

VSCODIUM_SETTINGS="$HOME/.config/VSCodium/User/settings.json"

if [ -f "$VSCODIUM_SETTINGS" ]; then
  sed -i -E "s/\"workbench.colorTheme\": \".*/\"workbench.colorTheme\": \"$VSCODIUM_THEME\"/g" "$VSCODIUM_SETTINGS"
  echo "⚙️  Tema de VSCodium actualizado a $VSCODIUM_THEME"
fi

Uses sed with regex to find and replace the workbench.colorTheme value in VSCodium’s settings.json.

7. Neovim Lua Bridge

mkdir -p "$HOME/.config/nvim/lua"
echo "return '$NVIM_THEME'" >"$HOME/.config/nvim/lua/theme_bridge.lua"

Creates a Lua module that LazyVim can import to get the current theme name.

8. Notification Components

echo "@import \"custom/$THEME.css\";" >"$HOME/.config/swaync/colors/colors.css"
echo "@import \"custom/$THEME.css\";" >"$HOME/.config/wlogout/colors/colors.css"

Updates SwayNC (notification daemon) and Wlogout (logout menu) themes.

9. System Monitors

ln -sf "$HOME/.config/btop/themes/custom/$THEME.theme" "$HOME/.config/btop/themes/colors.theme"
ln -sf "$HOME/.config/cava/themes/custom/$THEME" "$HOME/.config/cava/themes/colors"

Creates symbolic links for btop (system monitor) and Cava (audio visualizer) themes.

10. Service Reloads

# Reload SwayNC CSS
swaync-client -rs

# Reload Hyprland borders
hyprctl reload &>/dev/null

# Restart Waybar
killall waybar &>/dev/null
waybar &>/dev/null &
disown

# Hot-reload Ghostty
killall -SIGUSR2 ghostty

SwayNC

Uses swaync-client -rs to reload styles without restarting

Hyprland

Reloads configuration to apply new border colors

Waybar

Kills the old process and starts a new one in the background

Ghostty

Sends SIGUSR2 signal to trigger hot-reload

11. Dynamic Wallpaper Selection

WALLPAPER_DIR="$HOME/.config/hypr/wallpapers"
AVAILABLE_WALLPAPERS=$(find "$WALLPAPER_DIR" -maxdepth 1 -type f -iname "${THEME}*" | sort)

if [ "$COUNT" -eq 1 ]; then
  SELECTED_WALLPAPER="$AVAILABLE_WALLPAPERS"
else
  # Show Wofi menu for selection
  BASENAMES=$(echo "$AVAILABLE_WALLPAPERS" | xargs -n 1 basename)
  CHOICE=$(echo "$BASENAMES" | wofi --dmenu --prompt "🖼️ Elige fondo para $THEME:")
fi

hyprctl hyprpaper preload "$SELECTED_WALLPAPER" >/dev/null
hyprctl hyprpaper wallpaper ",$SELECTED_WALLPAPER" >/dev/null
hyprctl hyprpaper unload all >/dev/null

Smart wallpaper selection:

If only one wallpaper matches the theme, it’s selected automatically
If multiple wallpapers exist, Wofi menu appears for selection
Uses hyprctl commands to preload, set, and clean up wallpapers

12. Completion Notification

notify-send "$NOTIFY_ICON Tema aplicado" "El entorno ahora usa $THEME" -t 2000 -a "Theme Switcher"

Sends a desktop notification with a theme-specific icon (🌊 for Kanagawa, 📦 for Gruvbox, etc.).

Usage Examples

Command Line

# Switch to Kanagawa theme
theme-switcher kanagawa

# Switch to Gruvbox
theme-switcher gruvbox

# Switch to Catppuccin
theme-switcher catppuccin

# Switch to Everforest
theme-switcher everforest

From Theme Selector

The theme-selector script provides a graphical menu:

theme-selector

In Hyprland Config

# Direct theme switching
bind = SUPER_SHIFT, 1, exec, theme-switcher kanagawa
bind = SUPER_SHIFT, 2, exec, theme-switcher gruvbox
bind = SUPER_SHIFT, 3, exec, theme-switcher catppuccin

Components Updated

Hyprland

Border colors, window decorations

Waybar

Status bar colors and styling

Wofi

Application launcher theme

Ghostty

Terminal emulator colors

Neovim

Editor colorscheme

VSCodium

IDE theme

SwayNC

Notification daemon styling

Wlogout

Logout menu appearance

btop

System monitor theme

Cava

Audio visualizer colors

Hyprpaper

Wallpaper selection

Adding New Themes

To add support for a new theme:

Create theme files

Add CSS/config files for each component in their custom/ directories:

~/.config/waybar/colors/custom/mytheme.css
~/.config/wofi/colors/custom/mytheme.css
~/.config/hypr/colors/custom/mytheme.conf
~/.config/ghostty/colors/custom/mytheme
And so on…

Add to theme mapping

Edit the case statement in theme-switcher:

mytheme)
  VSCODIUM_THEME="My Theme Name"
  NVIM_THEME="mytheme"
  NOTIFY_ICON="✨"
  ;;

Add wallpaper

Place a wallpaper with the theme name prefix:

cp wallpaper.jpg ~/.config/hypr/wallpapers/mytheme-01.jpg

Update theme-selector

Add your theme to the list in theme-selector:

TEMAS="kanagawa\ngruvbox\ncatppuccin\neverforest\nmytheme"

Troubleshooting

Theme doesn't apply to all components

Check that all theme files exist:

ls ~/.config/waybar/colors/custom/kanagawa.css
ls ~/.config/hypr/colors/custom/kanagawa.conf
# etc.

Missing files will cause that component to not update.

Waybar doesn't reload

Check if Waybar is running:

pgrep waybar

Manually restart if needed:

killall waybar && waybar &

VSCodium theme not changing

Ensure the theme extension is installed in VSCodium and the theme name in the mapping matches exactly:

cat ~/.config/VSCodium/User/settings.json | grep colorTheme

Wallpaper not found

Verify wallpaper naming matches the theme:

ls ~/.config/hypr/wallpapers/kanagawa*

Wallpapers must start with the theme name (case-insensitive).

Ghostty doesn't hot-reload

If hot-reload fails, restart Ghostty manually:

killall ghostty && ghostty &

Performance Notes

The script uses &>/dev/null to suppress output from reload commands, preventing terminal clutter while still executing the commands.

Service reloads happen in parallel where possible
Waybar restart is backgrounded and disowned to avoid blocking
File updates use simple redirects for speed
Wallpaper selection only prompts when multiple options exist

Theme Selector

Interactive graphical theme selection menu

Theme Customization

Creating and customizing themes

Custom Scripts

Writing your own system scripts

Getting Started

Configuration

Themes

Components

Scripts

Guides

​Overview

​How It Works

​Complete Script

​Script Breakdown

​1. Input Validation

​2. CSS Updates (Waybar & Wofi)

​3. Hyprland Configuration

​4. Ghostty Configuration

​5. Theme Name Mapping

​6. VSCodium JSON Update

​7. Neovim Lua Bridge

​8. Notification Components

​9. System Monitors

​10. Service Reloads

​11. Dynamic Wallpaper Selection

​12. Completion Notification

​Usage Examples

​Command Line

​From Theme Selector

​In Hyprland Config

​Components Updated

Hyprland

Waybar

Wofi

Ghostty

Neovim

VSCodium

SwayNC

Wlogout

btop

Cava

Hyprpaper

​Adding New Themes

​Troubleshooting

​Performance Notes

​Related Documentation

Theme Selector

Theme Customization

Custom Scripts

Build docs developers (and LLMs) love

Overview

How It Works

Complete Script

Script Breakdown

1. Input Validation

2. CSS Updates (Waybar & Wofi)

3. Hyprland Configuration

4. Ghostty Configuration

5. Theme Name Mapping

6. VSCodium JSON Update

7. Neovim Lua Bridge

8. Notification Components

9. System Monitors

10. Service Reloads

11. Dynamic Wallpaper Selection

12. Completion Notification

Usage Examples

Command Line

From Theme Selector

In Hyprland Config

Components Updated

Adding New Themes

Troubleshooting

Performance Notes

Related Documentation