omarchy-zellij-theme   

Syncs your Zellij theme with your Omarchy system theme automatically.

Showcase.mp4

Every time you run omarchy theme set, Zellij picks up the same color palette in real time.

How it works

Omarchy's template engine processes zellij.kdl.tpl using the active theme's colors.toml, generating a KDL theme block in ~/.local/state/omarchy/current/theme/zellij.kdl. A theme-set hook converts the output from comma-separated RGB (R,G,B) to space-separated (R G B) and injects the themes {} block directly into ~/.config/zellij/config.kdl. Since Zellij watches its config file, existing sessions hot-reload the new theme instantly.

colors.toml ──> omarchy theme set/refresh ──> zellij.kdl (R,G,B)
                                              ~/.local/state/omarchy/current/theme/
                                                     │
                                               theme-set hook
                                            (sed R,G,B -> R G B)
                                                     │
                                                     ▼
                                      ~/.config/zellij/config.kdl
                                      (inline themes {} block)
                                                     │
                                                     ▼
                                          Zellij hot-reloads ✓

Color mapping

Zellij component	Omarchy color
Text base	foreground
Backgrounds	background, color0 (selected)
Ribbon selected	accent bg, background text
Ribbon unselected	color7 bg, background text
Frame selected	accent
Frame unselected	color8
Frame highlight	color3
Emphases	color1..color5 distributed across emphasis_0..3
Exit success / error	color2 / color1

Install

git clone https://github.com/skvggor/omarchy-zellij-theme.git
cd omarchy-zellij-theme
./install.sh

The installer:

1. Symlinks zellij.kdl.tpl into ~/.config/omarchy/themed/
2. Installs the theme-set hook into ~/.config/omarchy/hooks/theme-set.d/ (migrating legacy pre-Omarchy Quattro hooks)
3. Adds theme "omarchy" to ~/.config/zellij/config.kdl (creates a timestamped backup first)
4. Cleans up old theme file from previous approach if present
5. Generates and injects the current theme inline into config.kdl

It is safe to re-run -- the script is idempotent.

Upgrading to Omarchy Quattro

Omarchy Quattro moved the theme state to ~/.local/state/omarchy/current/ and changed the hook layout. If you installed a previous version of this theme, update and re-run the installer:

git pull
./install.sh

The installer migrates everything automatically:

• Moves the hook from the legacy single-file ~/.config/omarchy/hooks/theme-set to ~/.config/omarchy/hooks/theme-set.d/omarchy-zellij-theme (a custom hook of yours is preserved -- only the appended Zellij integration is removed)
• Re-reads theme state from ~/.local/state/omarchy/current/
• Re-injects the current theme into config.kdl, replacing any stale theme block

Save your work first: the last install step runs omarchy theme refresh, which restarts the terminal as part of applying the theme.

Uninstall

./uninstall.sh

This reverts everything:

1. Removes the template symlink from ~/.config/omarchy/themed/
2. Removes the hook from ~/.config/omarchy/hooks/theme-set.d/ (and any legacy pre-Omarchy Quattro integration)
3. Comments out theme "omarchy" in ~/.config/zellij/config.kdl
4. Removes the inline themes {} block from config.kdl
5. Cleans up old theme file if present

Zellij returns to its default theme on the next session.

Files

File	Purpose
zellij.kdl.tpl	Zellij theme template using {{ key_rgb }} placeholders
theme-set	Hook script -- converts RGB format and injects theme into config.kdl
theme-notify	Floating pane notification shown on theme change
install.sh	Installer (symlink, hook, config, initial apply)
uninstall.sh	Uninstaller (reverts all changes)

Requirements

• Omarchy Quattro or later with the template/hook system (omarchy theme set, omarchy theme refresh)
• Zellij with config at ~/.config/zellij/config.kdl

Usage

After installing, just use Omarchy as usual:

omarchy theme set tokyo-night   # Zellij theme updates instantly (all sessions)
omarchy theme set catppuccin    # same

All Zellij sessions -- including ones already running -- pick up the new theme in real time.