Daily Use: Themes

This section covers how to manage and apply themes in Omarchy. You will learn to list available themes, switch or cycle through them, install new ones, and cycle wallpapers.

Index

omarchy-theme-list

List all installed themes by name in a human-friendly format.

omarchy-theme-list
  • Scans ~/.config/omarchy/themes/ for directories or symlinks
  • Sorts and prints each theme with capitalized words
  • Helps you choose from available color schemes and layouts

omarchy-theme-set

Set a specific theme by name and apply it system-wide.

omarchy-theme-set <theme-name>
  • Updates the ~/.config/omarchy/current/theme symlink
  • Adjusts GNOME color-scheme and GTK theme via gsettings
  • Switches icon theme if icons.theme exists, defaults to Yaru-blue
  • Configures Chromium’s color scheme and theme color
  • Triggers Alacritty to reload by touching its config
  • Restarts components: Waybar, Hyprland, swayOSD, Hyprsunset (via hyprctl)
  • Invokes omarchy-theme-bg-next to set or refresh the wallpaper

omarchy-theme-next

Cycle to the next theme in the themes directory.

omarchy-theme-next
  • Finds all themes in ~/.config/omarchy/themes/
  • Determines the current theme via the current/theme symlink
  • Advances index by one, wrapping around at the end
  • Invokes omarchy-theme-set on the new theme
  • Notifies you via notify-send

omarchy-theme-install

Clone and install a new theme from a Git repository.

omarchy-theme-install <git-repo-url>
  • Prompts for URL if none supplied
  • Derives theme name from repo name (strips omarchy- and -theme)
  • Removes any existing theme directory with the same name
  • Clones the repo into ~/.config/omarchy/themes/
  • Automatically applies the new theme via omarchy-theme-set

omarchy-theme-bg-next

Cycle through wallpapers in the current theme.

omarchy-theme-bg-next
  • Loads all files under ~/.config/omarchy/current/theme/backgrounds/
  • Rotates the ~/.config/omarchy/current/background symlink
  • Relaunches swaybg to fill the screen with the new image
  • Fallbacks to a solid color if no backgrounds exist

Theme Application Workflow

This flowchart illustrates what happens when you run omarchy-theme-set:

flowchart TD
  A[User runs <br>omarchy-theme-set] --> B[Update theme <br>symlink]
  B --> C[Apply GNOME settings]
  C --> D[Configure Chromium<br/>color scheme & theme]
  D --> E[Touch Alacritty<br/>config file]
  E --> F[Restart Components]
  F --> G[Waybar, Hyprland,<br/>swayOSD, Hyprsunset]
  G --> H[Invoke omarchy-theme-bg-next]
  H --> I[Cycle wallpaper & reload swaybg]
  I --> J[Theme fully applied]

Command Reference

Command Description Usage
omarchy-theme-list List all installed themes omarchy-theme-list
omarchy-theme-set Apply a specified theme omarchy-theme-set <name>
omarchy-theme-next Cycle to the next theme omarchy-theme-next
omarchy-theme-install Install and apply a new theme from Git omarchy-theme-install <url>
omarchy-theme-bg-next Cycle theme wallpapers and reload the background omarchy-theme-bg-next

Use these commands daily to customize your Arch + Hyprland desktop with ease and style.