dotfiles/omarchy/README.md

Omarchy config

Omarchy 4 replaced waybar with the Quickshell bar built into omarchy-shell. shell.json is the whole bar config; it hot-reloads on save, and install.sh deploys it to ~/.config/omarchy/shell.json.

Bar layout

Ported from the old waybar/config.jsonc, section for section:

Old waybar module	shell.json widget
custom/omarchy	omarchy.menu
hyprland/workspaces	blob.workspaces (cloned plugin)
clock	blob.clock (custom module)
custom/update	omarchy.system-update
custom/voxtype	dropped (voxtype is not installed)
custom/screenrecording-indicator	AGS quick settings -> Record tile
custom/idle-indicator	AGS quick settings -> Stay Awake tile
custom/notification-silencing-indicator	AGS quick settings -> Silence tile
group/tray-expander	omarchy.tray
bluetooth	omarchy.bluetooth
network	omarchy.network
pulseaudio	omarchy.audio
battery	omarchy.power
cpu	blob.cpu (custom module)
custom/notification	blob.notifications (custom module)
(new in Omarchy 4)	omarchy.agents - AI agent usage
(new in Omarchy 4)	omarchy.monitor - brightness and display controls

The bar carries no omarchy.indicators widget: those four toggles live in the AGS quick settings panel instead, so the bar keeps only the clock and the update indicator in its center. Add { "id": "omarchy.indicators" } back to center to restore them (omit items for all six, which adds NightLight and Reminder).

Custom modules

The bar accepts arbitrary ids with type: "command", which is how the two AGS entry points survive the move off waybar:

• blob.cpu - left opens btop, middle opens alacritty, right toggles the AGS system monitor
• blob.notifications - left toggles the AGS notification center, right toggles notification silencing
• blob.clock - left toggles AGS quick settings, middle opens the shell's own calendar panel, right opens the timezone selector. omarchy.clock hardcodes its click actions, so matching the old waybar behavior needs a command module and centerAnchor pointed at it.

A command module with no exec key is a static icon; add exec and interval for one that refreshes its own text.

Cloned plugins

Both were made with omarchy plugin clone, which copies a built-in plugin, disables the original, and points the bar at the copy - hence the blob. ids in shell.json.

plugins/blob.workspaces/ clones omarchy.workspaces. The stock widget hardcodes workspaces 1-5 as always visible and has no setting for it, so the clone changes that list to 1-9 to match the old waybar persistent-workspaces.

plugins/blob.menu/ clones omarchy.menu to widen it. cardWidth in Menu.qml is hardcoded at Style.space(300); the clone raises it to 440, so the apps menu (Super + Space) and the root menu (Super + Alt + Space) are both wider. The two oversized menus (screen recording, font picker) keep their own 520 and are untouched. omarchy-menu still targets omarchy.menu on the CLI - the manifest records clonedFrom, and the shell routes those calls here.

Re-clone after an Omarchy update if the upstream widget gains something worth picking up: omarchy plugin clone omarchy.workspaces, then re-apply the one-line workspaceIds() change.

Editing

Dragging widgets in the bar rewrites ~/.config/omarchy/shell.json directly. That makes the live file diverge from this one, so after rearranging by hand, copy it back:

cp ~/.config/omarchy/shell.json omarchy/shell.json

Run ./install.sh --check to see whether the two have drifted.

Not portable from waybar

• Bar height: fixed by the shell's style (26px horizontal, 28px vertical).
• Per-widget click actions on first-party widgets: omarchy.network and omarchy.bluetooth own their popups, so the old right-click-into-AGS bindings only exist on the custom modules above.