Hypr Concierge

Your personal theme concierge for Hyprland/Wayland desktop environments.

Quick Start

1. Choose or define a theme (see themes.md for presets)
2. Read app-formats.md for target application's format
3. Edit config files in

   ~/dotfiles/{app}/.config/{app}/

4. Run

   cd ~/dotfiles && stow {app}

   if new files created
5. Reload each application

Workflow

Apply Preset Theme

User: "Switch to Catppuccin"

1. Read

   references/themes.md

   → get Catppuccin Mocha colors
2. Read

   references/app-formats.md

   → get format for each app
3. Edit each config file with theme colors:

   • ~/dotfiles/hypr/.config/hypr/hyprland.conf

   • ~/dotfiles/waybar/.config/waybar/style.css

   • ~/dotfiles/rofi/.config/rofi/tokyo-night.rasi

     (rename file if desired)

   • ~/dotfiles/mako/.config/mako/config

   • ~/dotfiles/ghostty/.config/ghostty/config

   • ~/dotfiles/tmux/.tmux.conf

4. Reload apps:

   hyprctl reload && makoctl reload && killall -SIGUSR2 waybar

5. Suggest Neovim colorscheme plugin if applicable

Describe Themes / Match Aesthetic

User: "Describe the available themes"
User: "I want something cozy and warm"
User: "What theme feels like a rainy day?"

1. Read

   references/themes.md

   → get aesthetic descriptions
2. For matching: compare user's mood/description to theme moods
3. Recommend 1-2 themes with explanation of why they fit
4. Offer to apply the recommended theme

Create Custom Theme

User: "Create a theme with blue and orange accents"

1. Read

   references/color-schema.md

   → understand required color slots
2. Generate cohesive palette based on user's description
3. Apply using same process as preset themes

Create Theme from Inspiration

User: "Create a theme inspired by the movie Hackers"
User: "I want a Blade Runner aesthetic"
User: "Make it feel like a forest at night"

1. Analyze the inspiration's visual language:
   • What are the dominant colors?
   • What's the mood/atmosphere?
   • What would "error" or "success" look like in that world?
2. Generate a cohesive palette following

   references/color-schema.md

3. Name the theme descriptively
4. Show the user the palette with rationale before applying
5. Save as a custom theme in

   ~/.config/hyprland-themes/saved/

Partial Theme Update

User: "Make waybar match my terminal colors"

1. Read the source config (e.g., ghostty) to extract current colors
2. Read target app's format from

   references/app-formats.md

3. Apply matching colors to target config only

Save Current Theme

User: "Save my current theme as cozy-dark"

1. Read

   references/theme-management.md

   for save procedure
2. Create

   ~/.config/hyprland-themes/saved/{name}/

   directory
3. Copy all current configs to the save directory
4. Create theme-info.txt with name, date, description
5. Update active-theme.txt

List Saved Themes

User: "What themes do I have saved?"

1. List contents of

   ~/.config/hyprland-themes/saved/

2. Read theme-info.txt from each
3. Indicate which is currently active

Switch/Restore Theme

User: "Switch to my tokyo-night theme"

1. Verify theme exists in saved themes
2. Offer to save current theme first if it has unsaved changes
3. Copy saved configs back to dotfiles locations
4. Re-stow dotfiles and reload all applications
5. Update active-theme.txt

List Themed Apps

User: "What apps can you theme?"

1. Read

   references/themed-apps.md

2. List all apps in the registry with their reload commands
3. Note any plugin-based apps (like Neovim)

Add New App to Theming

User: "Add kitty terminal to my themed apps"

1. Ask user for config file location and reload command
2. Determine color format by reading their existing config
3. Add entry to

   references/themed-apps.md

4. Add detailed format instructions to

   references/app-formats.md

5. Include the new app in future theme operations

Find Wallpapers for Theme

User: "Find wallpapers for my Hackers theme"
User: "I need a new wallpaper"

1. Search Wallhaven with theme-appropriate keywords (see

   references/wallpapers.md

   )
2. Collect wallpaper IDs and resolutions from results
3. Generate themed HTML preview page with thumbnails
4. Open preview in browser for user to browse visually
5. User selects wallpaper by ID
6. Download and apply selected wallpaper

Apply Wallpaper

User: "Use wallpaper l3qo2r" or "Download that one"

1. Download full resolution from Wallhaven
2. Save to

   ~/Pictures/

   with descriptive name
3. Update

   ~/dotfiles/hypr/.config/hypr/hyprpaper.conf

4. Reload hyprpaper:

   hyprctl hyprpaper reload

Themed Applications

hypr/.config/hypr/hyprland.conf

hyprctl reload

hypr/.config/hypr/hyprlock.conf

waybar/.config/waybar/style.css

killall -SIGUSR2 waybar

rofi/.config/rofi/*.rasi

mako/.config/mako/config

makoctl reload

ghostty/.config/ghostty/config

tmux/.tmux.conf

tmux source ~/.tmux.conf

Color Format Quick Reference

rgba(HEXaa)

rgba(7aa2f7ee)

#HEX

rgba(r,g,b,a)

#7aa2f7

rgba(122,162,247,0.9)

#HEXaa

#7aa2f7e6

#HEX

#7aa2f7

#HEX

#7aa2f7

#HEX

"fg=#7aa2f7"

Available Themes

Presets in

references/themes.md

• Tokyo Night (current default)
• Catppuccin Mocha
• Dracula
• Nord
• Gruvbox Dark
• Rose Pine
• Kanagawa

Theme Management

Saved themes stored in

~/.config/hyprland-themes/saved/

ls ~/.config/hyprland-themes/saved/

cat ~/.config/hyprland-themes/active-theme.txt

cat ~/.config/hyprland-themes/saved/{name}/theme-info.txt

See theme-management.md for full save/restore procedures.

References

• Themed Apps - Registry of apps to theme (add new apps here)
• App Formats - Per-application config formats and examples
• Themes - Preset theme palettes
• Color Schema - Semantic color definitions
• Theme Management - Save, restore, and switch themes
• Wallpapers - Wallpaper search, preview, and management