Initial import: chezmoi source for Omarchy (Hyprland)

Imported from prdlk/dotfiles master (efdd827), which supersedes the omarchy
branch (3031416). Drops the Umbriel, Noctalia, niri, CachyOS, macOS, and Blume
docs-site layers; docs/ is plain Markdown.

docs/desktop/README.md

@@ -0,0 +1,30 @@
+# Desktop
+
+The Linux desktop layer: Omarchy, the Hyprland config on top of it, the Waybar bar, fontconfig, and default applications.
+
+> [!NOTE]
+> **Role gating**
+>
+> `.chezmoiignore.tmpl` skips the Linux desktop layer unless the machine runs Linux **and** its role is `desktop` or `laptop`. The gated targets are `~/.config/hypr`, `~/.config/waybar`, `~/.config/uwsm`, `~/.config/fontconfig`, `~/.config/mimeapps.list`, `~/.config/xdg-terminals.list`, `~/.config/systemd`, `~/.local/bin/agent-root`, `~/.local/bin/kitty-day-save`, `~/.local/bin/cp-appid`, and `~/.local/bin/projects-sync`. On the `server` role these are not applied.
+>
+> The `omarchy-*` scripts in `~/.local/bin` are **not** listed there, so chezmoi applies them on every role.
+
+The desktop is [Omarchy](https://omarchy.org) (Arch Linux with Hyprland). Omarchy provides the compositor, the defaults, the theme, the menus, and the `omarchy-*` commands. This repo only overrides: a Hyprland Lua config (the `dot_config/hypr` submodule), a replacement Waybar layout, the `omarchy-*` helper scripts, the uwsm session environment, and the `~/.config/omarchy` external.
+
+| Page | Covers |
+| --- | --- |
+| [Hyprland](hyprland.md) | `~/.config/hypr` Lua config on Omarchy: bindings, input, look and feel, monitors, hyprsunset, the portal; every `omarchy-*` script in `~/.local/bin`. `~/.config/omarchy` (shell, hooks, menus, themes) is the [prdlk/omarchy](https://github.com/prdlk/omarchy) external, see [externals](../chezmoi/externals-and-ignore.md#chezmoiexternals) |
+| [Waybar](waybar.md) | `~/.config/waybar`: module layout, stylesheet, the `window_pill.py` title module |
+| [Fonts and default apps](fonts-and-apps.md) | `~/.config/fontconfig/fonts.conf`, `~/.config/mimeapps.list`, the Victor Mono Nerd Font package |
+
+## Packages
+
+`.chezmoidata/packages.yaml` declares the desktop packages under `packages.arch.desktop`. `.chezmoiscripts/run_onchange_before_10-packages.sh.tmpl` installs them only when the role is `desktop` or `laptop`:
+
+| Source | Packages |
+| --- | --- |
+| pacman | `uwsm`, `xdg-user-dirs`, Wayland utilities (`wl-clipboard`, `cliphist`, `wtype`, `ydotool`, `grim`, `slurp`, `hyprpicker`, `pamixer`, `brightnessctl`, `libnotify`), the bound apps (`nautilus`, `imv`, `mpv`, `evince`, `chromium`, `obsidian`), and strata's runtime deps |
+| AUR via `yay` (a sync repo wins when it has the name) | `tldraw-offline-bin` and the desktop apps `beeper-bin`, `fastmail`, `1password`, `brave-origin-bin`, `claude-desktop`, `spotify` |
+| `[omarchy]` repo, when configured | `herdr`, `flea`, `voxtype-bin`, `xdg-terminal-exec`, `hyprland-preview-share-picker` |
+
+AUR names that an installed package already provides are skipped; with no `yay` or `paru` the script bootstraps `yay` first. strata, the default file manager, comes from its own installer in [15-tools](../chezmoi/scripts.md#15-tools). Hyprland, Waybar, and the `omarchy-*` commands that the scripts call (`omarchy-menu`, `omarchy-launch-or-focus`, and others) come from the Omarchy install. This repo does not install them. See [chezmoi scripts](../chezmoi/scripts.md) for the full install flow and [packages.yaml](../chezmoi/data.md#packagesyaml) for the complete lists.

docs/desktop/fonts-and-apps.md

@@ -0,0 +1,94 @@
+# Fonts and default apps
+
+Fontconfig monospace override to Victor Mono Nerd Font, the Nerd Font packages, and the XDG default-application table.
+
+Two small files set system-wide defaults: `fonts.conf` picks the monospace font, and `mimeapps.list` picks which application opens each file type and URL scheme.
+
+> [!NOTE]
+> Linux `desktop` and `laptop` roles only. `.chezmoiignore.tmpl` skips `~/.config/fontconfig/**` and `~/.config/mimeapps.list` on other roles.
+
+## Fontconfig
+
+| Source (repo) | Target |
+| --- | --- |
+| `dot_config/fontconfig/fonts.conf` | `~/.config/fontconfig/fonts.conf` |
+
+**~/.config/fontconfig/fonts.conf**
+
+```xml
+<fontconfig>
+  <match target="pattern">
+    <test name="family" qual="any">
+      <string>monospace</string>
+    </test>
+    <edit name="family" mode="prepend_first" binding="strong">
+      <string>VictorMono Nerd Font</string>
+    </edit>
+  </match>
+</fontconfig>
+```
+
+Any font request that includes the generic `monospace` family gets `VictorMono Nerd Font` added to the front of its family list (`prepend_first`) with strong binding. Apps that ask for "monospace" therefore render in Victor Mono with Nerd Font glyphs, and fall back through fontconfig's normal monospace list if a glyph is missing. The file does not configure sans/serif families, hinting, antialiasing, or subpixel rendering. Those stay at system defaults.
+
+Some tools set their own fonts. Waybar uses `CaskaydiaCove Nerd Font Propo` (see [Waybar](waybar.md)), and the terminals set fonts in their own configs (see [kitty](../terminal/kitty.md)).
+
+### Font packages
+
+Victor Mono Nerd Font is installed on every role by `run_onchange_before_10-packages.sh.tmpl` from `.chezmoidata/packages.yaml`, not only on desktop roles. The package is `ttf-victor-mono-nerd` (pacman, `packages.arch.pacman`). `fonts.conf` is Linux desktop only, but the font package is also installed on `server`.
+
+## Default applications
+
+| Source (repo) | Target |
+| --- | --- |
+| `dot_config/mimeapps.list` | `~/.config/mimeapps.list` |
+
+`mimeapps.list` is the XDG file that `xdg-open`, GTK/Qt file dialogs, and browsers use to choose a handler. `[Default Applications]` sets the preferred handler. `[Added Associations]` adds entries to "Open with" lists.
+
+### Default applications
+
+| Group | MIME types / schemes | Handler (`.desktop`) |
+| --- | --- | --- |
+| Text and scripts | `text/plain`, `text/x-shellscript`, `text/x-python`, `text/x-script.python` | `vim.desktop` |
+| Notes | `text/markdown`, `application/x-obsidian-canvas`, `application/x-obsidian-base`, `x-scheme-handler/obsidian` | `obsidian.desktop` (`obsidian` from `packages.arch.desktop.pacman`) |
+| Web pages | `text/html`, `application/xhtml+xml`, `application/x-extension-htm`, `-html`, `-shtml`, `-xhtml`, `-xht` | `brave-origin.desktop` |
+| Web links | `x-scheme-handler/http`, `https`, `chrome` | `brave-origin.desktop` |
+| Browser internals | `x-scheme-handler/about`, `unknown` | `chromium.desktop` |
+| PDF | `application/pdf` | `brave-origin.desktop` |
+| Directories | `inode/directory` | `io.github.lgse.Strata.desktop` ([strata](../chezmoi/scripts.md#15-tools), which also registers the `org.freedesktop.FileManager1` service for "Open file location" and serves the portal file chooser) |
+| Mail | `x-scheme-handler/mailto` | `omamail.desktop` |
+| Windows executables | `application/vnd.microsoft.portable-executable` | `wine.desktop` |
+| AI tools | `x-scheme-handler/claude` | `com.anthropic.Claude.desktop` |
+| | `x-scheme-handler/claude-cli` | `claude-code-url-handler.desktop` |
+| | `x-scheme-handler/opencode` | `ai.opencode.desktop.desktop` |
+| | `x-scheme-handler/antigravity` | `antigravity.desktop` |
+| | `x-scheme-handler/piebald` | `piebald-handler.desktop` |
+| | `x-scheme-handler/openhuman` | `OpenHuman-handler.desktop` |
+| Productivity | `x-scheme-handler/todoist`, `com.todoist` | `todoist.desktop` |
+| | `x-scheme-handler/notion` | `notion.desktop` |
+| | `x-scheme-handler/anytype` | `anytype.desktop` |
+| | `x-scheme-handler/tolaria` | `tolaria-handler.desktop` |
+| | `x-scheme-handler/tldraw-offline` | `tldraw-offline.desktop` |
+| | `x-scheme-handler/figma` | `figma-linux.desktop` |
+| Chat | `x-scheme-handler/slack` | `slack.desktop` |
+| | `x-scheme-handler/discord-647066573147996160` | `discord-647066573147996161.desktop` |
+| Feeds | `x-scheme-handler/follow`, `folo` | `folo.desktop` |
+
+### Added associations
+
+| MIME types / schemes | Also offered |
+| --- | --- |
+| `http`, `https`, `chrome` schemes; `text/html`, `application/xhtml+xml`, and the `x-extension-*` web types | `brave-origin.desktop`, `userapp-Floorp-8MTFP3.desktop` |
+| `x-scheme-handler/mailto` | `userapp-Evolution-PCEYQ4.desktop` |
+| `application/vnd.microsoft.portable-executable` | `wine.desktop` |
+| `application/pdf` | `brave-origin.desktop` |
+| `x-scheme-handler/opencode` | `ai.opencode.desktop.desktop` |
+
+The added mail association is Evolution, but the default mail handler is `omamail.desktop`.
+
+> [!TIP]
+> In symlink mode, `~/.config/mimeapps.list` is a symlink into the repo. When `xdg-mime default` or a "set as default" dialog updates it, the tool either writes through the symlink and edits the repo file directly, or replaces the symlink with a regular file. Check `git status` or `chezmoi status` after changing defaults.
+
+## Related
+
+- [Hyprland](hyprland.md): the compositor these defaults serve.
+- [Installation](../installation.md): role selection that decides whether this layer applies.

docs/desktop/hyprland.md

@@ -0,0 +1,384 @@
+# Hyprland
+
+Hyprland Lua config layered on Omarchy — master layout, terminal-only blur, monitors, and the omarchy-* helper scripts.
+
+[Hyprland](https://hypr.land) is a dynamic tiling Wayland compositor. This config uses Hyprland's Lua configuration and sits on top of [Omarchy](https://omarchy.org), which provides the defaults, theme, menus, and `omarchy-*` commands. The files here only override.
+
+> [!NOTE]
+> Linux `desktop` and `laptop` roles only. `.chezmoiignore.tmpl` skips `~/.config/hypr/**` on other roles. The `omarchy-*` scripts are **not** listed there, so chezmoi applies them on every role and OS; they only take effect where Omarchy is installed.
+>
+> `dot_config/hypr` is a git submodule ([prdlk/hypr](https://github.com/prdlk/hypr)). Edit inside the submodule, commit there, then commit the updated pointer in the chezmoi repo.
+
+## Files
+
+| Source (repo) | Target | Purpose |
+| --- | --- | --- |
+| `dot_config/hypr/hyprland.lua` | `~/.config/hypr/hyprland.lua` | Entry point, workspace and window rules |
+| `dot_config/hypr/autostart.lua` | `~/.config/hypr/autostart.lua` | Extra autostart (empty) |
+| `dot_config/hypr/bindings.lua` | `~/.config/hypr/bindings.lua` | Keybindings |
+| `dot_config/hypr/input.lua` | `~/.config/hypr/input.lua` | Key repeat, tablet/touch mapping |
+| `dot_config/hypr/looknfeel.lua` | `~/.config/hypr/looknfeel.lua` | Layout, decoration, blur |
+| `dot_config/hypr/monitors.lua` | `~/.config/hypr/monitors.lua` | Monitor modes and positions |
+| `dot_config/hypr/hyprsunset.conf` | `~/.config/hypr/hyprsunset.conf` | Night-light profile |
+| `dot_config/hypr/xdph.conf` | `~/.config/hypr/xdph.conf` | xdg-desktop-portal-hyprland |
+| `dot_config/hypr/dot_luarc.json` | `~/.config/hypr/.luarc.json` | Lua language server settings |
+| `dot_local/bin/executable_omarchy-*` | `~/.local/bin/omarchy-*` | Helper scripts (see [below](#omarchy-scripts)) |
+
+None are templates. Hyprland and Omarchy are not in `.chezmoidata/packages.yaml`. They come from the Omarchy install.
+
+## Entry point
+
+`hyprland.lua` loads Omarchy, then the personal files, then Omarchy's toggles:
+
+**~/.config/hypr/hyprland.lua**
+
+```lua
+dofile((os.getenv("OMARCHY_PATH") or "/usr/share/omarchy") .. "/default/hypr/bootstrap.lua")
+require("default.hypr.omarchy")
+
+require("hypr.monitors")
+require("hypr.input")
+require("hypr.bindings")
+require("hypr.looknfeel")
+require("hypr.autostart")
+
+require("default.hypr.toggles")
+```
+
+Omarchy's default bindings stay enabled. `omarchy_default_bindings` and `omarchy_preinstalled_bindings` are left commented. `bindings.lua` unbinds each default it replaces.
+
+### Workspace rules
+
+| Workspace | Monitor |
+| --- | --- |
+| 1 (default), 2, 3, 4 | The main external display: `desc:Apple Computer Inc StudioDisplay 0x984262A7` if connected, else `desc:Samsung Electric Company S34CG50 HNTY501103` (Studio Display while neither is). Chosen at config load; `monitors.lua` reloads the config when the main external changes, and existing workspaces 1–4 are moved over |
+| 5 (default), 6, 7, 8 | `eDP-1` |
+
+`default` marks the workspace each monitor shows when it connects.
+
+### Window rules
+
+| Class | Rule |
+| --- | --- |
+| `^brave-www\.tldraw\.com__-Default$` | Workspace 3 |
+| `^tldraw-offline$` | Workspace 5, fullscreen |
+| `^so\.stencil\.tern$` | `special:scratchpad silent` |
+| `^com\.anthropic\.Claude$` | `special:claude silent` |
+| `^com\.fastmail\.Fastmail$` | `special:fastmail silent` |
+| `^Beeper$` | `special:beeper silent` |
+| `^brave-home\.google\.com__.*` | `special:home silent` |
+| `^ai\.elementlabs\.lmstudio$` | `special:lmstudio silent` |
+| `brave-(www\.)?youtube\.com__.*`, title not matching `.*Picture.?in.?[Pp]icture.*` | Float, pin, size 30% × 30% of the monitor, move to `10, monitor_h*0.7-10` (bottom-left corner) |
+
+Scratch residents are placed `silent` so that [`omarchy-toggle-scratch`](#omarchy-toggle-scratch) decides when to reveal them. The YouTube rule matches both `youtube.com` and `www.youtube.com` because Chromium's class changes once a video plays. It excludes the picture-in-picture overlay so Omarchy's own PiP rule still applies. Its size and inset must stay in sync with [`omarchy-pip`](#omarchy-pip).
+
+## Input
+
+`input.lua`:
+
+- `repeat_delay = 250` (Omarchy's value), `repeat_rate = 50` (raised from 40). The file's comments record that 200/50 felt too fast. The typing lag it was meant to fix came from the keyboard's firmware tap-hold handling and was fixed on the keyboard itself.
+- Tablet and touch devices are pinned to one output each:
+
+| Device | Output | Extra |
+| --- | --- | --- |
+| `elan9008:00-04f3:43c7-stylus` (Flow Z13 pen) | `eDP-1` | |
+| `elan9008:00-04f3:43c7` (Flow Z13 touchscreen) | `eDP-1` | Taps land on the panel instead of the focused monitor |
+| `wacom-intuos-bt-s-pen` | The main external display (Studio Display or Samsung ultrawide) | `active_area_size = { 152, 152 × height / width }` (85.5 on the Studio Display, 63.6 on the ultrawide), `active_area_position = { 0, 0 }` — a full-width band with the display's aspect ratio |
+
+The layout, touchpad, and gesture examples in the file are commented out. Palm rejection is done by a libinput quirks file in `/etc`, which chezmoi does not manage.
+
+## Look and feel
+
+`looknfeel.lua` loads after the Omarchy theme's `hyprland.lua`, so its values override the theme's. The theme sets colors. This file sets everything else. The approach is flat windows by default, with blur only behind terminals.
+
+| Setting | Value |
+| --- | --- |
+| `general.layout` | `master` (instead of Omarchy's dwindle; per-workspace layouts saved by `omarchy-hyprland-workspace-layout-toggle` still win) |
+| `decoration.rounding` | 0 |
+| `decoration.dim_special` | 0.33 (darkens the desktop behind any open scratch workspace) |
+| `decoration.blur` | enabled; `size 5`, `passes 2`, `brightness 0.8`, `contrast 1.1`, `vibrancy 0.15`, `noise 0.01`, `new_optimizations`, `popups = false` |
+| `decoration.shadow` | disabled |
+| `group.groupbar.gradient_rounding` | 0 |
+| Workspace animation | disabled (`hl.animation({ leaf = "workspaces", enabled = false })`) |
+
+Blur must be enabled globally before any window can use it, so every window tagged `default-opacity` gets `no_blur = true`, and terminals get it back:
+
+**~/.config/hypr/looknfeel.lua**
+
+```lua
+o.window({ tag = "default-opacity" }, { no_blur = true })
+o.window(
+  "^(kitty(-.*)?|Alacritty|com\\.mitchellh\\.ghostty|foot|org\\.codeberg\\.dnkl\\.foot|wezterm)$",
+  { no_blur = false }
+)
+```
+
+Omarchy's stock fade (0.985 active / 0.96 inactive) is kept. Terminals get their transparency from kitty's `background_opacity 0.9` (see [kitty](../terminal/kitty.md)). The comments give the reason for limiting blur: the cyberdream and Spectra themes enabled rounding, blur, and shadow on every window, and that costs frame time on an iGPU driving the laptop panel plus a 5K display.
+
+## Monitors
+
+`monitors.lua`:
+
+| Output | Mode | Position | Scale |
+| --- | --- | --- | --- |
+| any (fallback) | `preferred` | `auto` | 3.2 |
+| `eDP-1` (laptop) | `2560x1600@180` | `auto-right` | 2 |
+| `DP-4` (Apple Studio Display) | `5120x2880@60` | `0x0` | 2 |
+| `desc:Samsung Electric Company S34CG50 HNTY501103` (ultrawide, USB-C to HDMI from the iGPU; shows up as a `DP-n` connector) | `3440x1440@100` | `0x0` | 1 |
+
+`GDK_SCALE=3` is exported. The external display sits left of the laptop panel; `auto-right` puts `eDP-1` at its logical width (2560 for the Studio Display, 3440 for the ultrawide), or at 0 when undocked. `monitors.lua` returns the "main external display" (Studio Display, else Samsung ultrawide) used by the workspace rules, the Wacom mapping, and `omarchy-toggle-scratch`, and reloads the config on hotplug when it changes.
+
+`~/.config/uwsm/env-hyprland` (source `dot_config/uwsm/env-hyprland`, Linux desktop/laptop only) is sourced by uwsm before Hyprland starts. It sets `AQ_DRM_DEVICES` to the AMD iGPU, resolved from `/dev/dri/by-path/pci-0000:c4:00.0-card`, so Hyprland never opens the Thunderbolt eGPU (RTX 5060 Ti, compute only: AI models, CUDA). Every display, the Samsung ultrawide included, hangs off the iGPU. It leaves the variable unset if that path is missing. It also sets `__EGL_VENDOR_LIBRARY_FILENAMES` to Mesa's `50_mesa.json`, so neither Hyprland nor session apps load `libEGL_nvidia` and hold `/dev/nvidiactl`; CUDA does not use EGL.
+
+The system side (kernel cmdline, `nvidia` without KMS, `thunderbolt host_reset=0`) lives outside chezmoi.
+
+## hyprsunset and portal
+
+**~/.config/hypr/hyprsunset.conf**
+
+```ini
+profile {
+    time = 07:00
+    identity = true
+}
+```
+
+The identity profile stops hyprsunset from tinting the screen. A commented 20:00 / 4000 K night profile and an `o.launch_on_start("hyprsunset")` hint remain in the file.
+
+**~/.config/hypr/xdph.conf**
+
+```ini
+screencopy {
+    allow_token_by_default = true
+    custom_picker_binary = hyprland-preview-share-picker
+}
+```
+
+Screen-share requests get a restore token by default and use `hyprland-preview-share-picker` as the source picker.
+
+## .luarc.json
+
+Configures lua-language-server for the Lua config: the library path is `/usr/share/hypr/stubs`, `checkThirdParty` is off, and `hl` and `o` are declared as globals.
+
+`autostart.lua` contains only a commented `o.launch_on_start` example.
+
+## Keybindings
+
+Every binding defined in `bindings.lua`. Bindings not listed here are Omarchy defaults. The *Replaces* column gives the Omarchy default that was unbound first.
+
+### Windows
+
+| Keys | Action | Replaces |
+| --- | --- | --- |
+| `SUPER + Q` | Close window | same (made explicit) |
+| `SUPER + W` | `omarchy-toggle-layout` — flip workspace layout | close window |
+| `SUPER + BACKSPACE` | Focus last window | toggle transparency |
+| `SUPER + TAB` | Next window in the active workspace | next workspace |
+| `SUPER + SHIFT + TAB` | Previous window in the active workspace | previous workspace |
+| `SUPER + H` / `J` / `K` / `L` | Focus left / down / up / right | `J`: toggle split, `K`: keybindings menu, `L`: toggle layout |
+| `SUPER + D` | Toggle split (dwindle `togglesplit`) | — |
+| `SUPER + SHIFT + H` | `omarchy-smart-move l` — move/merge left; floating: bottom-left corner | — |
+| `SUPER + SHIFT + J` | `omarchy-smart-move d` — move/merge down; floating: top-left | — |
+| `SUPER + SHIFT + K` | `omarchy-smart-move u` — move/merge up; floating: top-right | — |
+| `SUPER + SHIFT + L` | `omarchy-smart-move r` — move/merge right; floating: bottom-right | — |
+| `SUPER + SHIFT + T` | `omarchy-pip` — toggle picture-in-picture | — |
+
+`SUPER + TAB` walks a ring built only from the active workspace's mapped windows, ordered by `stable_id`. Grouped windows stay in the ring and hidden ones are skipped. It raises the focused window afterwards. It avoids `cyclenext`, which would pull in a hidden scratchpad. `binds.movefocus_cycles_groupfirst = true` makes `hjkl` focus step through a group's tabs before leaving the group.
+
+### Workspaces and monitors
+
+| Keys | Action | Replaces |
+| --- | --- | --- |
+| `SUPER + CTRL + J` | Next workspace (`e+1`) | — |
+| `SUPER + CTRL + K` | Previous workspace (`e-1`) | Herdr keybindings |
+| `ALT + Q` / `W` / `E` / `R` | Switch to workspace 1 / 2 / 3 / 4 (main external display) | — |
+| `ALT + Y` / `U` / `I` / `O` | Switch to workspace 5 / 6 / 7 / 8 (laptop panel) | — |
+| `ALT + SHIFT + Q` / `W` / `E` / `R` / `Y` / `U` / `I` / `O` | Move window to workspace 1–8 | — |
+| `SUPER + CTRL + S` | `omarchy-toggle-scratch scratchpad` | share menu |
+| `SUPER + A` | `omarchy-toggle-scratch scratchpad` (Tern) | — |
+| `SUPER + O`, `SUPER + SHIFT + O` | Unbound | pop window out, Obsidian |
+| `ALT + SHIFT + J` | Move window to next monitor | — |
+| `ALT + SHIFT + K` | Move window to previous monitor | — |
+| `SUPER + SHIFT + CTRL + ALT + W` | Workspace `name:w` | — |
+| `SUPER + SHIFT + CTRL + ALT + H` | Workspace `name:h` | — |
+| `SUPER + CTRL + ALT + X` | Workspace `name:x` | — |
+
+Named workspaces provide the per-app workspaces. `SUPER + ALT + S` (send to scratchpad) keeps its Omarchy default.
+
+### Sizing
+
+| Keys | Action |
+| --- | --- |
+| `SUPER + R` | `omarchy-cycle-window-size` — next preset size |
+| `SUPER + SHIFT + R` | `omarchy-cycle-window-size prev` |
+| `ALT + SHIFT + H` / `SUPER + ,` | Width −100 px |
+| `ALT + SHIFT + L` / `SUPER + .` | Width +100 px |
+| `SUPER + CTRL + K` | Height −100 px |
+| `SUPER + CTRL + J` | Height +100 px |
+| `SUPER + ALT + C` | Fit active column (scrolling layout only) |
+| `SUPER + SHIFT + ALT + C` | Fit visible columns (scrolling layout only) |
+
+### Applications
+
+| Keys | Action | Replaces |
+| --- | --- | --- |
+| `SUPER + CTRL + A` | Claude: `omarchy-launch-or-focus claude "gtk-launch com.anthropic.Claude"` | audio panel |
+| `SUPER + CTRL + G` | Gemini: `omarchy-launch-or-focus gemini "gtk-launch gemini-desktop"` | — |
+| `SUPER + CTRL + ALT + H` | `omarchy-cycle ai` | — |
+| `SUPER + CTRL + ALT + J` | `omarchy-cycle-terminal` | — |
+| `SUPER + CTRL + ALT + K` | `omarchy-cycle-browser` | — |
+| `SUPER + CTRL + ALT + G` | `omarchy-cycle ghostty` | — |
+| `SUPER + CTRL + ALT + O` | `omarchy-cycle obsidian` | — |
+| `SUPER + CTRL + ALT + F` | strata: `omarchy-launch-or-focus io.github.lgse.Strata "gtk-launch io.github.lgse.Strata"` | — |
+| `SUPER + CTRL + ALT + E` | `omarchy-toggle-scratch fastmail` | — |
+| `SUPER + CTRL + ALT + M` | `omarchy-toggle-scratch beeper` | — |
+| `SUPER + CTRL + L` | `omarchy-toggle-scratch lmstudio` (LM Studio) | toggle window gaps |
+| `SUPER + CTRL + ALT + Y` | `omarchy-summon youtube` | web apps cycle |
+| `SUPER + SHIFT + Y` | `omarchy-summon youtube` | YouTube desktop entry |
+| `SUPER + CTRL + ALT + T` | tldraw offline: `omarchy-launch-or-focus tldraw-offline "gtk-launch tldraw-offline"` | show time |
+| `SUPER + CTRL + ALT + W` | tldraw: `omarchy-launch-or-focus tldraw "gtk-launch TLDraw"` | toggle weather |
+| `SUPER + CTRL + ALT + SPACE` | Sticky Notes Canvas via `gtk-launch io.github.faridjaff.StickyNotesCanvas` | — |
+| `SUPER + SHIFT + G` | Goliath: `kitty --class=kitty-goliath --title=goliath --config ~/.config/kitty/goliath.conf` | Signal |
+| `SUPER + ALT + SHIFT + F` | `uwsm-app -- "$HOME/.local/bin/strata" "$(omarchy-cmd-terminal-cwd)"` — strata in the terminal's cwd | unbound first (default unnamed) |
+
+strata is the default file manager: `inode/directory` in `mimeapps.list` and the `org.freedesktop.FileManager1` D-Bus service both point at it ([15-tools](../chezmoi/scripts.md#15-tools)). The cwd bind uses the absolute path because `~/.local/bin` may be missing from uwsm-app's `PATH`. Omarchy's own file-manager bind on `SUPER + SHIFT + F` is replaced by full screen (below). A rule tagging `com.thisisgm.flea.picker` as `+floating-window` still sits between `flea --picker` marker comments, which the `flea` tool writes and removes itself.
+
+### Screenshots, session, menus
+
+| Keys | Action | Replaces |
+| --- | --- | --- |
+| `SUPER + S` | `omarchy-capture-screenshot region` | toggle scratchpad |
+| `SUPER + SHIFT + S` | `omarchy-capture-screenshot windows` | Google Maps |
+| `SUPER + SHIFT + ALT + S` | `omarchy-capture-screenshot fullscreen` | — |
+| `SUPER + SHIFT + E` | `omarchy-menu toggle system` | Email |
+| `SUPER + SHIFT + Q` | `omarchy-menu toggle system` | — |
+| `SUPER + F24` | `voxtype record toggle --profile hermes` — dictation | — |
+| `SUPER + SHIFT + SPACE` | Emoji picker (`omarchy-shell shell toggle omarchy.emojis`) | toggle top bar |
+| `SUPER + P` | Clipboard manager (`omarchy-shell shell toggle omarchy.clipboard`) | pseudo window |
+| `ALT + TAB` | ScrollOverview `toggle all` (only when the plugin is loaded) | Omarchy's two `ALT + TAB` binds |
+
+`SUPER + SPACE` (Omarchy menu) and `SUPER + ALT + SPACE` (apps menu) keep their Omarchy defaults. `SUPER + RETURN` (terminal) and `SUPER + SHIFT + RETURN` (browser) are unbound; terminals and browsers live on `SUPER + CTRL + ALT + J` / `K`.
+
+### ScrollOverview plugin
+
+When `hl.plugin.scrolloverview` is present, `bindings.lua` configures it:
+
+| Option | Value |
+| --- | --- |
+| `gesture_distance` | 300 |
+| `scale` | 0.5 |
+| `workspace_gap` | 100 |
+| `layout` | `vertical` |
+| `wallpaper` | 2 (global and per-workspace) |
+| `blur` | true |
+| `shadow` | enabled, range 50 |
+
+## omarchy scripts
+
+The scripts live in `dot_local/bin/` as `executable_omarchy-*` and deploy to `~/.local/bin/`. Each one calls the Lua dispatcher first (`hyprctl dispatch "hl.dsp…"`) and falls back to the classic dispatcher name on older Hyprland.
+
+### omarchy-cycle
+
+```sh
+omarchy-cycle <app|browser|brave|terminal|ai|ghostty|kitty|kitty-CLASS|webapp|webapp-NAME>
+```
+
+Focuses an app's window, cycles to the next one on repeated presses, or launches the app when none is open. Windows are matched on `class` or `initialClass` (case-insensitive) and sorted by workspace, then address. If the focused window is not in the set, focus goes to the first one. Launches use `setsid uwsm-app --`.
+
+| Argument | Matches | Launches when none |
+| --- | --- | --- |
+| `webapp` | `^(webapp-\|chrome-)` | re-runs as `webapp-youtube` |
+| `webapp-NAME` | `webapp-NAME` or `^chrome-.*NAME` | `gtk-launch` on the first `WebApp-NAME*.desktop` or `*NAME*.desktop` in `~/.local/share/applications` |
+| `kitty` | `^kitty` | `kitty` |
+| `kitty-CLASS` | `^kitty-CLASS$` | `kitty --class kitty-CLASS` (command from the empty `KITTY_CMDS` map, if set) |
+| `ghostty` | `ghostty` | `ghostty` |
+| `browser` | zen, brave, chromium, google-chrome, firefox, librewolf, vivaldi, microsoft-edge, helium — excluding `chrome-`/`webapp-` web apps | `omarchy-launch-browser` |
+| `brave` | `^brave` (Brave Origin and its web apps) | `omarchy-launch-browser` |
+| `terminal` | kitty, alacritty, ghostty, foot, wezterm (Tern, the scratchpad terminal, does not match) | `omarchy-launch-terminal` (`xdg-terminal-exec`: the OS default terminal from `~/.config/xdg-terminals.list`, in the focused terminal's cwd) |
+| `ai` | `claude\|hermes` | `hermes desktop` |
+| anything else | `^APP$` | the argument as a command |
+
+Bound to `SUPER + CTRL + ALT + H` (`ai`), `G` (`ghostty`), and `O` (`obsidian`).
+
+### omarchy-cycle-browser / omarchy-cycle-terminal
+
+One-line wrappers: `omarchy-cycle brave` and `omarchy-cycle terminal`. Bound to `SUPER + CTRL + ALT + K` and `SUPER + CTRL + ALT + J`.
+
+### omarchy-launch-browser
+
+```sh
+omarchy-launch-browser [--private] [url]
+```
+
+Shadows Omarchy's `/usr/bin/omarchy-launch-browser` (`~/.local/bin` comes first on `PATH`) and hands off to it. When Brave Origin is the default browser and not running, it prepends `--restore-last-session --hide-crash-restore-bubble`, so the first launch after a reboot or power-off reopens the last session's windows without the "Restore pages?" prompt. Chromium treats a killed browser as crashed and skips the restore; `--hide-crash-restore-bubble` clears that state. Private launches and launches into a running browser pass through unchanged.
+
+### omarchy-cycle-window-size
+
+```sh
+omarchy-cycle-window-size [next|prev]
+```
+
+Steps the focused window through preset widths `0.333, 0.5, 0.667` of the monitor.
+
+- **Scrolling layout (tiled):** sends `colresize +conf` / `-conf`, so the layout's own preset list is used.
+- **Floating:** resizes to the fraction × monitor width and 0.8 × monitor height, then centers. The index is stored per window.
+- **Dwindle/master (tiled):** sets `splitratio` to `2 × fraction`, mirrored when the window is on the right or bottom half, clamped to 0.1–1.9. The index is stored per workspace.
+
+Indices are stored in `$XDG_STATE_HOME/omarchy/window-sizes/`. Bound to `SUPER + R` and `SUPER + SHIFT + R`.
+
+### omarchy-pip
+
+```sh
+omarchy-pip [toggle|on] [address:0x...]
+```
+
+Picture-in-picture for any window. Floats and pins it, resizes it to 30% of the focused monitor on both axes, and places it in the bottom-left corner with a 10 px inset (matching `general:gaps_out`). `toggle` (the default) unpins and re-tiles a window that is already floating and pinned. `on` always applies the fit. Defaults to the active window. The dispatcher is called with `on`/`off` because `set` toggles on Hyprland 0.56. Bound to `SUPER + SHIFT + T`. `omarchy-summon` also calls it.
+
+### omarchy-smart-move
+
+```sh
+omarchy-smart-move <l|r|u|d>
+```
+
+- **Tiled:** finds the nearest tiled, visible window in that direction that overlaps on the other axis. If that neighbor, or the focused window, is in a group, it runs a group-aware move (`movewindoworgroup`), which merges into or leaves a group. Otherwise it swaps with the neighbor.
+- **Floating:** moves the window to a corner of its monitor without resizing, inside the reserved area (the bar) and inset 10 px. Corners go clockwise from bottom-left: `l` bottom-left, `d` top-left, `u` top-right, `r` bottom-right.
+
+Bound to `SUPER + SHIFT + H/J/K/L`.
+
+### omarchy-summon
+
+```sh
+omarchy-summon [youtube]
+```
+
+The only profile is `youtube`, which matches class `^brave-(www\.)?youtube\.com__.*$` and skips Picture-in-Picture titles. With no window open, it runs `gtk-launch YouTube`, and the window rule in `hyprland.lua` floats and positions it. With a window open, it moves the window to the focused monitor, runs `omarchy-pip on` to refit it (the two panels differ in logical size), and focuses it. Bound to `SUPER + CTRL + ALT + Y` and `SUPER + SHIFT + Y`.
+
+### omarchy-toggle-layout
+
+```sh
+omarchy-toggle-layout [width]
+```
+
+Runs `omarchy-hyprland-workspace-layout-toggle`, then polls the workspace layout (6 × 50 ms). If it became `scrolling`, it runs `colresize all <width>` (default `0.75`). Dwindle needs no widths. Bound to `SUPER + W`.
+
+### omarchy-toggle-scratch
+
+```sh
+omarchy-toggle-scratch [scratchpad|claude|fastmail|beeper|home|lmstudio]
+```
+
+| Profile | Special workspace | Home monitor | Residents (class → launch) |
+| --- | --- | --- | --- |
+| `scratchpad` | `special:scratchpad` | Studio Display, else Samsung ultrawide | `so.stencil.tern` → `tern` |
+| `claude` | `special:claude` | Studio Display, else Samsung ultrawide | `com.anthropic.Claude` → `claude-desktop` |
+| `fastmail` | `special:fastmail` | `eDP-1` | `com.fastmail.Fastmail` → `gtk-launch com.fastmail.Fastmail` |
+| `beeper` | `special:beeper` | `eDP-1` | `Beeper` → `gtk-launch beeper` |
+| `home` | `special:home` | focused | `brave-home\.google\.com__.*` → `gtk-launch 'Google Home'` |
+| `lmstudio` | `special:lmstudio` | focused | `ai\.elementlabs\.lmstudio` → `gtk-launch ai.elementlabs.lmstudio` |
+
+If the workspace is visible, the script hides it. If not, it launches any resident with no window there, waits up to 8 s for the first new window, and reveals the workspace on the home monitor (or the focused one if the home monitor is absent). Launching only missing residents avoids duplicate web-app windows. Bound to `SUPER + CTRL + S`, `SUPER + A`, `SUPER + CTRL + ALT + E`, `SUPER + CTRL + ALT + M`, `SUPER + CTRL + H`, and `SUPER + CTRL + L`.
+
+## Related
+
+- [Waybar](waybar.md): the bar used with this setup.
+- [kitty](../terminal/kitty.md): the `herdr` and `goliath` kitty configs launched here.

docs/desktop/waybar.md

@@ -0,0 +1,136 @@
+# Waybar
+
+Bottom Waybar for Hyprland/Omarchy — module layout, a drawer of system indicators, the window-title pill, and theme-driven styling.
+
+[Waybar](https://github.com/Alexays/Waybar) is a status bar for wlroots-based and Hyprland compositors. This config replaces Omarchy's default bar with a bottom-docked layout. It uses Hyprland and Omarchy modules and commands, so it pairs with the [Hyprland](hyprland.md) setup.
+
+> [!NOTE]
+> `~/.config/waybar` is part of the role-gated desktop layer in `.chezmoiignore.tmpl`, so it applies on `desktop` and `laptop` roles only. Waybar itself comes from Omarchy and is not in `.chezmoidata/packages.yaml`.
+
+## Files
+
+| Source (repo) | Target |
+| --- | --- |
+| `dot_config/waybar/config.jsonc` | `~/.config/waybar/config.jsonc` |
+| `dot_config/waybar/style.css` | `~/.config/waybar/style.css` |
+| `dot_config/waybar/window_pill.py` | `~/.config/waybar/window_pill.py` |
+| `dot_config/waybar/V6.cb.png` | `~/.config/waybar/V6.cb.png` |
+
+> [!WARNING]
+> `window_pill.py` has no `executable_` prefix, and the repo file is mode `0644`. In symlink mode, chezmoi links `~/.config/waybar/window_pill.py` to that non-executable file. The module's `exec` calls the path directly, so it only runs if the executable bit is set by hand (`chmod +x` on the source) or the file is renamed to `executable_window_pill.py`.
+
+`V6.cb.png` is a 1920×921 reference screenshot of this bar, taken with a floating btop window over a plain background. No config file references it.
+
+![Waybar reference screenshot (V6.cb.png)](./waybar-preview.png)
+
+## Bar settings
+
+| Option | Value |
+| --- | --- |
+| `position` | `bottom` |
+| `exclusive` | true (reserves space) |
+| `fixed-center` | true |
+| `spacing` | 2 |
+| `margin-top` | 1 |
+| `reload_style_on_change` | true |
+
+## Layout
+
+**Left**
+
+- separator
+- `custom/omarchy`
+- separator
+- `hyprland/workspaces`
+- separator
+- `tray`
+- separator
+- `custom/voxtype`
+- `custom/update`
+- `custom/screenrecording-indicator`
+- `custom/updatespacman`
+- separator
+- `idle_inhibitor`
+
+**Center**
+
+- `custom/windowpill`
+
+**Right**
+
+- `group/right-group2` → `group/right2` → `group/tray-expander`
+- `group/right-group1` → `group/right1` → `clock`
+
+The right side nests groups in vertical wrappers so the drawer and the two-line clock align. `group/tray-expander` is a drawer (600 ms transition, children class `tray-group-item`). It shows only `custom/expand-icon` until hovered, then reveals: `backlight`, `bluetooth`, `pulseaudio#output`, `pulseaudio#input`, `power-profiles-daemon`, `network`, `memory`, `cpu`, `battery`.
+
+## Modules
+
+| Module | Configuration |
+| --- | --- |
+| `custom/separator` (also `separator2`, `separator3`, defined but unused) | Literal `\|`, no tooltip |
+| `custom/omarchy` | Omarchy logo glyph (`omarchy` font). Click: `omarchy-menu`. Right-click: `xdg-terminal-exec`. Tooltip "Omarchy Menu — Super + Alt + Space" |
+| `hyprland/workspaces` | `format "{icon}"`, click to activate, pointer cursor. Persistent workspaces per output, matching the [Hyprland workspace rules](hyprland.md#workspace-rules): 1–4 on `DP-4` (Studio Display), 5–8 on `eDP-1`. Keyed by connector name, so a re-dock onto another DP port needs the key updated |
+| `tray` | Icon size 12, spacing 5, shows passive items |
+| `custom/voxtype` | `omarchy-voxtype-status` (JSON). Icons for `idle` (none), `recording`, `transcribing`. Click: `omarchy-voxtype-model`. Right-click: `omarchy-voxtype-config` |
+| `custom/update` | `omarchy-update-available` every 6 h (`interval 21600`, `signal 7`). Click runs `omarchy-update` in a floating terminal |
+| `custom/screenrecording-indicator` | `$OMARCHY_PATH/default/waybar/indicators/screen-recording.sh` (JSON, `signal 8`). Click: `omarchy-capture-screenrecording` |
+| `custom/updatespacman` | `waybar-module-pacman-updates --no-zero-output`, only if that binary exists. Shows an icon when updates are pending |
+| `idle_inhibitor` | Activated/deactivated icons |
+| `custom/windowpill` | `~/.config/waybar/window_pill.py` (JSON, `restart-interval 1`), centered |
+| `clock` | `{:%H:%M\n%d/%m/%Y}` (two lines); alt `{:%H:%M - %d/%m/%Y}`. Month calendar tooltip (3 columns; month `#ffead3`, weekdays `#ffcc66`, today `#ff6699`). Right-click: `omarchy-tz-select` in a floating terminal |
+| `backlight` | Device `intel_backlight`, 15-step icon ramp, tooltip shows percent |
+| `bluetooth` | Off/on/connected icons, tooltip shows connection count. Click: `omarchy-launch-bluetooth` |
+| `pulseaudio#output` | Icon only (headphone or 3-step speaker, muted icon). Max 100%, scroll step 2. Click: `omarchy-launch-audio`. Right-click: `pamixer -t` (mute) |
+| `pulseaudio#input` | Mic / muted-mic icon. Max 100%, scroll step 1 via `pactl set-source-volume`. Click: `omarchy-launch-audio`. Right-click: `pamixer -t` |
+| `power-profiles-daemon` | Icons for performance / balanced / power-saver. Tooltip shows profile and driver |
+| `network` | 5-step Wi-Fi signal icons; ethernet and disconnected icons. Tooltips show ESSID, frequency, and bandwidth. Polls every 3 s. Click: `omarchy-launch-wifi` |
+| `memory` | `{used:0.1f}G` every 2 s. Click: `omarchy-launch-or-focus-tui btop` |
+| `cpu` | `{usage}%` every 10 s. Click: btop |
+| `battery` | `{capacity}% {icon}` with 10-step charging and discharging ramps. Warning at 20%, critical at 10%, polled every 5 s. Click: `omarchy-menu power`. Right-click: `notify-send` of `omarchy-battery-status` |
+
+Icons are Nerd Font glyphs.
+
+## window_pill.py
+
+A Python script that feeds `custom/windowpill` a two-line label for the focused window:
+
+- **Top line:** the window class, small, `#a6adc8`, lowered with `rise='-2000'`.
+- **Bottom line:** the title, bold, size 11000, `#ffffff`, truncated to 80 characters (`MAX_TITLE_LEN`). For Discord/Vesktop it removes the unread counter prefix such as `(209) ` and a leading `Discord | `.
+- **No focused window:** shows `Workspace <id>` over a non-breaking space.
+
+Text is HTML-escaped for Pango and printed as JSON (`class: custom-window`, tooltip `class: title`). After the first print it connects to Hyprland's event socket `/tmp/hypr/$HYPRLAND_INSTANCE_SIGNATURE/.socket2.sock` and reprints on `activewindow>>` and `workspace>>` events. It exits if `HYPRLAND_INSTANCE_SIGNATURE` is unset, which means the module does nothing outside Hyprland.
+
+## Styling
+
+`style.css` imports the active Omarchy theme's palette, so colors follow whatever theme Omarchy has selected (for example cyberdream):
+
+**~/.config/waybar/style.css**
+
+```css
+@import "/home/prad/.local/state/omarchy/current/theme/waybar.css";
+```
+
+The import path is hard-coded to `/home/prad`. On another account the import fails and the `@background` / `@foreground` colors are undefined.
+
+| Element | Style |
+| --- | --- |
+| All | `font-family: 'CaskaydiaCove Nerd Font Propo'`, no borders or text shadow, square corners |
+| Bar box (`#waybar > box`) | `@background` fill, `@foreground` text, 2px/6px margins, 4px radius, `box-shadow 0 1px 2px` black, weight 700, size 12px, min height 30px, 0.5 s background transition |
+| Window background | `@transparent` |
+| Workspace buttons | Opacity 0.55. Active 1.0. Empty 0.2. Empty and active 1.0. Bold 12px |
+| Modules | 6px horizontal padding, 1px margins, min width 12px |
+| Separators | Opacity 0.25 |
+| `custom/updatespacman` | Opacity 0.55 |
+| `custom/expand-icon` | Opacity 0.5 |
+| `custom/update` | 10px font |
+| Tray | `@background`. Passive items dimmed, attention items highlighted |
+| Tooltips | `@background`, 12px, 8px radius, `1.5px solid rgba(255,255,255,0.25)` border |
+| Screen recording active | `#eb7087`, blinks to `@background` every 0.5 s |
+| Voxtype recording | `#a55555` |
+| Battery warning | `#c95d0f` |
+| Battery critical (not charging) | `#e6d8ba` on transparent, blinking to `#f53c3c` (0.5 s, 12 steps) |
+
+## Related
+
+- [Hyprland](hyprland.md): the compositor this bar is built for.
+- [Fonts and default apps](fonts-and-apps.md): Nerd Font packages.