omarchy

Source excerpt starting at line 1.

1# Omarchy Shell: Bar, Plugins, and Idle2 3Read this before changing the status bar, notifications, shell plugins,4widgets, or idle/lock behavior.5 6The bar, notification daemon, settings panel, and assorted overlays all run7inside a single long-running Quickshell process (`omarchy-shell`).8 9```10~/.config/omarchy/shell.json             # User overrides: bar, plugins, idle11~/.config/omarchy/plugins/<plugin-id>/   # User-owned shell plugins12$OMARCHY_PATH/config/omarchy/shell.json  # Canonical defaults13```14 15The shell hot-reloads `shell.json` on save — no restart needed for layout16changes. `idle.screensaver` and `idle.lock` are seconds since user idle began.17 18**Commands:** `omarchy restart shell`, `omarchy refresh shell`19 20## Bar Layout21 22Use the `omarchy bar` group to move and manage widgets:23 24```bash25omarchy bar move omarchy.clock --section right26```27 28For layout edits beyond what the commands cover, edit the bar configuration29in `~/.config/omarchy/shell.json`; it hot-reloads on save.30 31## Customizing Built-In Plugins and Widgets32 33To customize a built-in bar widget, never edit `$OMARCHY_PATH/shell/plugins/`.34Clone it into the user plugin directory instead:35 36```bash37omarchy plugin clone omarchy.workspaces38# Edit ~/.config/omarchy/plugins/<username>.workspaces/; saved changes reload automatically.39```40 41Cloning switches the bar to the cloned copy (e.g. `<username>.workspaces`),42which is yours to edit and survives updates.43 44Saving a file anywhere under `~/.config/omarchy/plugins/` reloads plugin code45automatically. If a change somehow fails to apply, force a reload with46`omarchy-shell shell rescanPlugins`.47 48## Idle and Lock49 50Set `idle.screensaver` and `idle.lock` in `~/.config/omarchy/shell.json`,51in seconds since user idle began. Example: "lock after ten minutes" means52setting `idle.lock` to `600`.53