OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
omarchy-theming high occasional DISPUTE

Recover the bar after `omarchy plugin clone omarchy.bar` removes it entirely

omarchyomarchy-4hyprlandwaylandnvidiaamddesktop
CORRECTED An auditor found the fix wrong or incomplete and rewrote it.
AUDIT NOTE

The commands are right: bin/omarchy-plugin-clone (<source-id> [--edit]) and bin/omarchy-plugin-remove ([id] [--yes], with --yes|-y parsed explicitly) both exist with those exact signatures, and PLUGINS_DIR is ~/.config/omarchy/plugins. The shell.toml [bar] keys are valid and ~/.config/omarchy/shell.toml is a real layered override. But the shell.json snippet is actively harmful as written: "layout": { "left": [], "center": [], "right": [] } produces a completely blank bar, and manual/05-the-top-bar.md warns that once you own shell.json there is no deep merge with Omarchy's defaults, so pasting that is a second way to lose the bar. Omarchy ships first-class commands for exactly these cases, which the record omits.

The cause above was not rewritten and may still contain the error described. The fix below is the corrected version.
RISK

omarchy plugin remove <user>.bar --yes deletes the cloned plugin directory including any edits you made to it. Copy ~/.config/omarchy/plugins/<user>.bar/Bar.qml somewhere safe first if you want to keep your changes.

Symptom

You clone the built-in bar plugin to customize it and the bar disappears from every monitor, even with a byte-for-byte unmodified copy. omarchy-plugin-list --json reports the clone as "enabled": true, "active": true, but hyprctl layers shows no omarchy-bar surface anywhere. The shell log has WARN scene: file:///home/<user>/.config/omarchy/plugins/<user>.bar/Bar.qml[15:3]: Required property omarchyPath was not initialized (and the same for barWidgetRegistry and barConfig), followed by WARN scene: @shell.qml[256:-1]: ReferenceError: errorString is not defined.

Cause

omarchy plugin clone copies the QML but the clone is not wired to receive the required properties the shell injects into the built-in bar (omarchyPath, barWidgetRegistry, barConfig), so the component fails to instantiate and takes the bar down on all monitors. The errorString ReferenceError is a secondary bug in shell.qml's own error-handling path that masks the real load error.

Fix

Remove the clone to get the stock bar back immediately:


omarchy plugin remove <user>.bar --yes
omarchy restart shell

Check what happened first if you want the log:


omarchy-plugin-list --json
hyprctl layers | grep omarchy-bar
tail -50 /run/user/$UID/quickshell/by-id/*/log.qslog

**Do not paste a hand-written empty layout.** The original's "layout": { "left": [], "center": [], "right": [] } yields a completely blank bar, a second way to lose it. Layout entries are objects like {"id": "omarchy.clock"}, and once you own shell.json there is no deep merge with Omarchy's defaults, so new default widgets never appear. Use the supported commands instead:


omarchy bar defaults                 # restore the shipped layout
omarchy bar position top             # top | bottom | left | right
omarchy bar transparent toggle
omarchy bar move omarchy.clock --section center --index 0

omarchy plugin list                  # every widget id the shell knows
omarchy plugin enable omarchy.media --section center
omarchy plugin disable omarchy.weather

Sizing and typography live in ~/.config/omarchy/shell.toml, which layers over the active theme:


[font]
base-size = 12

[bar]
size-horizontal = 32
scale-with-font = true

Only scale-with-font, size-horizontal and size-vertical are read from [bar]. Every other key there is silently ignored. The shell watches the file, so no restart is normally needed. Run omarchy restart shell if in doubt.

There is still no per-monitor bar restriction in shell.json. That case has no workaround.

Verify

hyprctl layers | grep omarchy-bar shows a bar layer on each monitor and the bar is visible again. omarchy-plugin-list --json no longer lists <user>.bar.

Sources

bar-plugin-clone-kills-the-bar