Restore Waybar customizations wiped by `omarchy refresh waybar` on Omarchy 3
The refresh half holds: v3.8.4 bin/omarchy-refresh-waybar calls omarchy-refresh-config on config.jsonc and style.css, and omarchy-refresh-config copies the default over the user file, keeps <file>.bak.<date +%s>, and deletes the backup when identical. #5821 (dhh: copy the .baks back) supports the recovery, and #370 (fixed by #402) is why backups are timestamped. The position half is wrong for Omarchy 3.x: bin/omarchy-style-waybar-position is not in the v3.8.4 tree. Its history is afcfaf6b 'Control Waybar position (#5730)' on 2026-05-10 and c0e099f on 2026-05-12, and the GitHub compare API shows c0e099f is an ancestor of v4.0.0-beta3 and v4.0.4 but diverged from v3.7.1, v3.8.0 and v3.8.4. So the Style > Waybar position menu existed only on the Omarchy 4 development branch for two days, never in a 3.x release, and 4.0.4-1 ships no Waybar. The symptom also misquoted the message: refresh-config prints the full path plus a 'Saved backup as' line. Omarchy 4 note confirmed: 4.0.4-1 omarchy-refresh-config behaves the same, and bar layout is in ~/.config/omarchy/shell.json. Symptom, cause and fix corrected. Frequency lowered, because the position path affected only development-branch users.
Symptom
Omarchy 3.x: my custom Waybar modules and CSS are gone. It happened right after omarchy refresh waybar, which I ran while troubleshooting. The terminal printed Replaced /home/<user>/.config/waybar/config.jsonc with new Omarchy default., then Saved backup as /home/<user>/.config/waybar/config.jsonc.bak.<timestamp>., then a diff, and the same for style.css. On an Omarchy 4 development build from May 2026, picking Style > Waybar > Top/Bottom/Left/Right did the same.
Cause
omarchy-refresh-waybar calls omarchy-refresh-config on both waybar/config.jsonc and waybar/style.css. That copies the shipped defaults from ~/.local/share/omarchy/config/ over your files and keeps your version as <file>.bak.<unix-timestamp>, deleting the backup only when it is identical to the new default. A refresh is a deliberate reset, and the maintainer confirmed in #5821 that copying the .bak files back is the intended recovery. The timestamped backup names come from #402, which fixed #370, where a second refresh overwrote the only backup. The position menu is a separate case: omarchy-style-waybar-position was added on the Omarchy 4 development branch on 2026-05-10 (#5730) and ran both refreshes before changing the position until commit c0e099f on 2026-05-12. It is not in any 3.x release (v3.8.4 does not ship it), and 4.0.4-1 ships no Waybar, so only machines tracking that development branch in those two days hit it.
Fix
Omarchy 3.x: find the newest backups and copy them back:
ls -lt ~/.config/waybar/*.bak.* | head
cp ~/.config/waybar/config.jsonc.bak.<timestamp> ~/.config/waybar/config.jsonc
cp ~/.config/waybar/style.css.bak.<timestamp> ~/.config/waybar/style.css
omarchy-restart-waybar
Use the timestamp just before the reset. date -d @<timestamp> shows when each was taken. If the restored style.css lacks the first line @import "../omarchy/current/theme/waybar.css";, add it back or the bar loses its theme colors.
To change the bar position on 3.x, edit "position" in ~/.config/waybar/config.jsonc by hand and run omarchy-restart-waybar.
Omarchy 4: there is no Waybar. omarchy-refresh-config still backs up and replaces the files it manages the same way, but the bar's layout lives in ~/.config/omarchy/shell.json, so this record does not apply.
Verify
Your modules are back on the bar after omarchy-restart-waybar.