Omarchy 4 Config Files: Where to Look

A quick reference to the main config files in Omarchy 4 and what each one is generally responsible for.

~/.config/omarchy/shell.toml

Controls the Quickshell-based top bar — font, sizing, background, opacity. A machine-level override that sits on top of whatever theme is active, so changes here survive theme switches.

~/.config/foot/foot.ini

Config for foot, Omarchy's default terminal — font, size, transparency/alpha, colors.

~/.config/hypr/looknfeel.lua

General window appearance: gaps, border size, corner rounding, blur, animations.

~/.config/hypr/input.lua

Input device settings: keyboard layout, mouse/trackpad behavior, scroll direction, per-device overrides.

~/.config/hypr/bindings.lua

Keybindings and window rules (app-specific behavior like opacity, floating, workspace assignment).

~/.config/hypr/monitors.lua

Monitor/display configuration — resolution, position, scale.

~/.config/hypr/autostart.lua

Programs and commands that run automatically when Hyprland starts.

~/.config/hypr/hyprland.lua

The actual entry point Hyprland loads on startup. It require()s all the files above. Rarely edited directly, but useful to know it exists.

~/.config/hypr/hyprland.conf

Legacy Hyprland config format, largely inactive in Omarchy 4 since the switch to Lua — worth knowing it's there so you don't waste time editing it by mistake.