6ee243cc37
* Split the end-user omarchy skill into topic guides Move default/omarchy-skill to default/agents/skills/omarchy and break the monolithic SKILL.md into on-demand topic files for Hyprland config, shell plugins, theming, and hooks. Update the skill symlink wiring, relink existing installs through a migration, and correct claims that had drifted from the implementation: plugin hot-reload, terminal reload, menu customization, refresh scopes, theme overlays, background locations, hook timing, and the packaged (not git-managed) system directory. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * Add capture and contributing guides to the omarchy skill Cover screenshots, screen recording, OCR text capture, and LocalSend or Taildrop sharing, plus how to route bug reports, suggestions, and support questions upstream with diagnostics and captures of the problem attached. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * Scope Hyprland reload guidance to the Lua config files hyprsunset.conf and xdph.conf are read by separate processes, so hyprctl neither applies nor validates them. Document restarting hyprsunset after editing its config, including in the night light example. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
53 lines
1.8 KiB
Markdown
53 lines
1.8 KiB
Markdown
# Omarchy Shell: Bar, Plugins, and Idle
|
|
|
|
Read this before changing the status bar, notifications, shell plugins,
|
|
widgets, or idle/lock behavior.
|
|
|
|
The bar, notification daemon, settings panel, and assorted overlays all run
|
|
inside a single long-running Quickshell process (`omarchy-shell`).
|
|
|
|
```
|
|
~/.config/omarchy/shell.json # User overrides: bar, plugins, idle
|
|
~/.config/omarchy/plugins/<plugin-id>/ # User-owned shell plugins
|
|
$OMARCHY_PATH/config/omarchy/shell.json # Canonical defaults
|
|
```
|
|
|
|
The shell hot-reloads `shell.json` on save — no restart needed for layout
|
|
changes. `idle.screensaver` and `idle.lock` are seconds since user idle began.
|
|
|
|
**Commands:** `omarchy restart shell`, `omarchy refresh shell`
|
|
|
|
## Bar Layout
|
|
|
|
Use the `omarchy bar` group to move and manage widgets:
|
|
|
|
```bash
|
|
omarchy bar move omarchy.clock --section right
|
|
```
|
|
|
|
For layout edits beyond what the commands cover, edit the bar configuration
|
|
in `~/.config/omarchy/shell.json`; it hot-reloads on save.
|
|
|
|
## Customizing Built-In Plugins and Widgets
|
|
|
|
To customize a built-in bar widget, never edit `$OMARCHY_PATH/shell/plugins/`.
|
|
Clone it into the user plugin directory instead:
|
|
|
|
```bash
|
|
omarchy plugin clone omarchy.workspaces
|
|
# Edit ~/.config/omarchy/plugins/<username>.workspaces/; saved changes reload automatically.
|
|
```
|
|
|
|
Cloning switches the bar to the cloned copy (e.g. `<username>.workspaces`),
|
|
which is yours to edit and survives updates.
|
|
|
|
Saving a file anywhere under `~/.config/omarchy/plugins/` reloads plugin code
|
|
automatically. If a change somehow fails to apply, force a reload with
|
|
`omarchy-shell shell rescanPlugins`.
|
|
|
|
## Idle and Lock
|
|
|
|
Set `idle.screensaver` and `idle.lock` in `~/.config/omarchy/shell.json`,
|
|
in seconds since user idle began. Example: "lock after ten minutes" means
|
|
setting `idle.lock` to `600`.
|