Host Overrides

UWSM environment

Quattro provides /usr/share/uwsm/env.d/10-omarchy and /usr/share/omarchy/default/uwsm/default, including the user-local binary path and mise activation. The stowed ~/.config/uwsm/env.d/90-dotfiles adds only the custom Hypr helper path and OpenCode feature flags, without copying the generated 99-omarchy-upgrade-env or timestamped upgrade backups. Omarchy keeps BROWSER shell-scoped so browser default selection continues to work.

Ghostty host overrides

Ghostty config is a stowed dotfiles package (ghostty/.config/ghostty/), not a tracked Omarchy repo. The stowed ghostty-host-config launcher checks OMARCHY_HOST and loads ~/.config/ghostty/config.$OMARCHY_HOST when present, falling back to the default ~/.config/ghostty/config otherwise.

The shared config uses 12px window padding. The laptop override reduces the padding to 8px and the font size from 10 to 9.

Binding	Action
CTRL+ALT+G	Toggle the unified Omarchy Shell Git panel
CTRL+ALT+SHIFT+G	Type and run lazygit in Ghostty
CTRL+ALT+TAB	Send tmux’s next-window sequence
CTRL+ALT+SHIFT+TAB	Send tmux’s previous-window sequence

dot install, dot init, and dot stow back up the retired timmo001/omarchy-ghostty clone at ~/.config/ghostty before linking the stowed config.

Hyprland host overrides

Hyprland config is a stowed dotfiles package (hypr/.config/hypr/), not a tracked repo. Host-specific Lua overrides live under ~/.config/hypr/hosts/$OMARCHY_HOST, selected by the runtime ~/.config/hypr/host symlink.

• dot stow lays down the Hypr package with --no-folding and creates/repairs ~/.config/hypr/host to point at the active host.
• dot init selects the Hypr host early (via --host <name>, defaulting to OMARCHY_HOST or desktop), and the stow phase creates the host symlink.
• dot doctor checks the host link and flags any leftover legacy omarchy-hypr clone at ~/.config/hypr.
• Both host monitor overrides detect common virtual machines through DMI data and use unscaled toolkit and fallback monitor settings; bare-metal hosts keep their normal HiDPI scale.

Shared Hypr autostart lives in ~/.config/hypr/autostart.lua and runs on every host before the selected host override is loaded. Host-only services stay in ~/.config/hypr/host/autostart.lua. KDE Connect starts on both hosts, while the OpenCode server starts only on the desktop.

Retired omarchy-hypr clone

A machine with the retired ~/.config/hypr omarchy-hypr clone halts dot update until the clone is backed up and re-stowed. Hyprland config is a stowed package, not a cloned repo.

Environment

• OMARCHY_HOST — the Hypr host override name (e.g. desktop, laptop).
• OMARCHY_REPO_BASE_DIR — Omarchy repo base path (default ~/.config).

See Environment Variables for the full list.