Remove the migration too

Revert "Add battery identifier to Waybar config"
2026-08-02 20:28:19 +02:00 · 2026-04-22 07:52:25 +02:00 · 2026-04-22 07:51:12 +02:00
1214 changed files with 7599 additions and 61769 deletions
@@ -1,11 +0,0 @@
-{
-  "workspace": {
-    "library": [
-      "/usr/share/hypr/stubs"
-    ],
-    "checkThirdParty": false
-  },
-  "diagnostics": {
-    "globals": ["hl"]
-  }
-}
@@ -6,18 +6,12 @@
 - Prefer `(( ))` over numeric operators inside `[[ ]]` (e.g., `(( count < 50 ))`, not `[[ $count -lt 50 ]]`)
 - For strings/paths with spaces, quote them instead of escaping spaces with `\ ` (e.g., `"$APP_DIR/Disk Usage.desktop"`, not `$APP_DIR/Disk\ Usage.desktop`)
 - Shebangs must use `#!/bin/bash` consistently (never `#!/usr/bin/env bash`)
- Scripts under `install/` and `migrations/` may be sourced and intentionally omit shebangs

 # Command Naming

-All commands start with `omarchy-`. Prefixes indicate purpose.
-
-The authoritative command group list lives in `bin/omarchy` in `GROUP_DESCRIPTIONS`. Keep `GROUP_DESCRIPTIONS` updated when adding a new command prefix.
-
-Common prefixes include:
+All commands start with `omarchy-`. Prefixes indicate purpose:

 - `cmd-` - check if commands exist, misc utility commands
- `capture-` - screenshots, screen recordings, and other capture tools
 - `pkg-` - package management helpers
 - `hw-` - hardware detection (return exit codes for use in conditionals)
 - `refresh-` - copy default config to user's `~/.config/`
@@ -29,138 +23,20 @@ Common prefixes include:
 - `theme-` - theme management
 - `update-` - update components

-Other current prefixes include:
-
- `ac-`, `audio-`, `battery-`, `branch-`, `brightness-`, `channel-`, `config-`, `debug-`, `dev-`, `drive-`, `first-`, `font-`, `haptic-`, `hibernation-`, `hook-`, `hyprland-`, `menu-`, `migrate-`, `notification-`, `npm-`, `plymouth-`, `powerprofiles-`, `reinstall-`, `remove-`, `screensaver-`, `show-`, `snapshot-`, `state-`, `sudo-`, `system-`, `transcode-`, `tui-`, `tz-`, `upload-`, `version-`, `voxtype-`, `webapp-`, `wifi-`, `windows-`
-
-# Command Metadata
-
-Commands in `bin/` can declare CLI metadata in comments near the top of the file. `bin/omarchy` scans the first 80 lines, and tests expect command metadata to remain valid.
-
-Supported metadata keys:
-
- `# omarchy:summary=...` - short help text
- `# omarchy:args=...` - usage arguments
- `# omarchy:examples=...` - examples separated with ` | `
- `# omarchy:alias=...` / `# omarchy:aliases=...` - alternate routes
- `# omarchy:hidden=true` - hide from default command listings
- `# omarchy:requires-sudo=true` - mark commands that require sudo
-
-Only use `omarchy:examples` where there are args that need explaining.
-
-Prefer explicit metadata for user-facing commands. Keep routes consistent with the filename unless there is a deliberate alias or compatibility route.
-
-Example:
-
-```bash
-# omarchy:summary=Take a screenshot
-# omarchy:args=[smart|region|windows|fullscreen] [slurp|copy]
-# omarchy:examples=omarchy screenshot | omarchy capture screenshot region
-```
-
-# Runtime Environment
-
- `$OMARCHY_PATH` is set at the top level by the uwsm session environment and is always available to Omarchy runtime code.
- Commands in `bin/` and Quickshell QML should rely on `$OMARCHY_PATH` / `Quickshell.env("OMARCHY_PATH")`; do not derive fallback paths from `HOME`, `Quickshell.shellDir`, or re-export/default `OMARCHY_PATH` manually.
-
-# Privileged Commands
-
- Whenever you need to trigger a sudo command, use `pkexec` so it results in a user prompt they can approve.
-
-# Git
-
- Commits should be atomic: include only one coherent change or fix, and do not mix unrelated work.
- Commit messages should be succinct and describe the change being made.
-
-# Install Scripts
-
-Install entry points (`install.sh`, `boot.sh`) use `#!/bin/bash`. Many scripts under `install/` are sourced via `run_logged` and intentionally do not have shebangs.
-
-Install stage files follow this pattern:
-
- `install/*/all.sh` lists scripts in execution order
- leaf scripts are sourced by `run_logged $OMARCHY_INSTALL/path/to/script.sh`
- avoid `exit` in sourced install scripts unless intentionally aborting the install
- use `$OMARCHY_INSTALL` and `$OMARCHY_PATH` instead of hard-coded Omarchy paths
- keep hardware-specific logic under `install/config/hardware/`
- prefer helper commands for package and command checks where available
-
-Raw `command -v`, `pacman`, and `pacman-key` are acceptable in bootstrap/preflight/package-helper contexts where the helper commands may not be available yet or where direct package-manager behavior is the point of the script.
-
 # Helper Commands

 Use these instead of raw shell commands:

 - `omarchy-cmd-missing` / `omarchy-cmd-present` - check for commands
- `omarchy-pkg-missing` / `omarchy-pkg-present` - check for packages (don't use these if you can just use `omarchy-pkg-add`/`omarchy-pkg-drop`)
+- `omarchy-pkg-missing` / `omarchy-pkg-present` - check for packages
 - `omarchy-pkg-add` - install packages (handles both pacman and AUR)
- `omarchy-pkg-drop` - remove packages; use this instead of raw `pacman -R*`
- `omarchy-notification-send` - send desktop notifications; do not call `notify-send` directly
 - `omarchy-hw-asus-rog` - detect ASUS ROG hardware (and similar `hw-*` commands)

-Exceptions are allowed for bootstrap, preflight, migration, and package-helper scripts where the helper may not be available yet, where the helper itself is being implemented, or where direct package-manager behavior is required.
-
 # Config Structure

 - `config/` - default configs copied to `~/.config/`
 - `default/themed/*.tpl` - templates with `{{ variable }}` placeholders for theme colors
- `themes/*/colors.toml` - theme color definitions (accent, background, foreground, red/green/yellow/blue/magenta/cyan and bright_* variants)
-
-# Tests
-
-Run focused automated tests for the area you changed. Current test entry points:
-
- `./test/all` - aggregate runner for CLI and shell tests
- `./test/cli` - CLI routing, command metadata, theme helpers, and safe dispatch coverage
- `./test/shell` - all Omarchy shell tests under `test/shell.d/`
-
-New Omarchy shell tests should live in `test/shell.d/*-test.sh` so `./test/shell` picks them up automatically. Source `test/shell.d/base-test.sh` for shared root-path discovery, assertions, and Node test helpers.
-
-For visual changes, such as omarchy-shell styling, desktop appearance, screenshots, or screen recording flows, verify with the running UI in addition to automated tests. Take and analyze screenshots with `omarchy capture screenshot fullscreen save`. For animation, transitions, capture, or screen recording behavior, make a short recording with `omarchy screenrecord --fullscreen`, stop it with `omarchy screenrecord --stop-recording`, and review the output before finishing.
-
-For interactive UI work, use `wtype` to simulate keyboard input when available. Example: start the UI in the background, wait briefly for focus, then run `wtype -k Right -k Return` to exercise keyboard selection and confirm the resulting command output or state change. Prefer this over manual-only verification when a UI returns a selected value or changes a symlink/config.
-
-When testing layer-shell UI, capture the reference and candidate states as separate screenshots, then compare them visually before further edits. If a launched UI would otherwise remain open, keep track of its PID and stop it after the screenshot; avoid broad process kills unless checking with `ps` first.
-
-# Omarchy shell
-
-The Quickshell desktop runs as a single long-running process out of
-`shell/`. Hyprland autostart launches it directly with `quickshell -p`; do
-not start additional standalone `quickshell -p` instances for individual
-components.
-
-Run `omarchy-restart-shell` after making changes to QML files.
-
-Plugin contract:
-
- Each plugin lives in its own directory under
-  `shell/plugins/<id>/` (first-party) or
-  `~/.config/omarchy/plugins/<id>/` (third-party).
- Every plugin ships a `manifest.json` declaring `id`, `kinds`,
-  `activation`, and `entryPoints`. The full schema is in
-  [`docs/omarchy-shell.md`](docs/omarchy-shell.md).
- Entry-point QML files are `Item`s (not `ShellRoot`), and accept the
-  shell-injected properties `omarchyPath`, `shell`, `manifest`, and
-  `pluginRegistry` / `barWidgetRegistry` as appropriate.
- Panel / overlay / menu plugins must expose `open(payloadJson)` and
-  `close()` lifecycle methods for `shell summon` and `shell hide`.
-
-IPC:
-
- `bin/omarchy-shell` is the canonical IPC entry point. It forwards to
-  the running shell and does not start it. Prefer it over re-implementing
-  direct Quickshell socket calls in every CLI.
- The `shell` IPC target exposes `ping`, `summon`, `hide`, `toggle`,
-  `rescanPlugins`, `setPluginEnabled`, and `listPlugins`. Individual
-  plugins can register additional IPC targets (the bar registers `bar`,
-  the background switcher registers `image-selector`).
-
-Widget files in `shell/plugins/bar/widgets/` contain Nerd Font glyphs as raw
-unicode characters. The `Write` and `Edit` tools strip multi-byte
-codepoints in some positions — do **not** rewrite widget files wholesale
-through those tools. For glyph fixes, use the targeted `Edit` tool with
-the surrounding context, or a Python script that inserts codepoints via
-`chr(0xXXXXX)`.
+- `themes/*/colors.toml` - theme color definitions (accent, background, foreground, color0-15)

 # Refresh Pattern

@@ -176,13 +52,16 @@ This copies `~/.local/share/omarchy/config/hypr/hyprlock.conf` to `~/.config/hyp

 To create a new migration, run `omarchy-dev-add-migration --no-edit`. This creates a migration file named after the unix timestamp of the last commit.

-New migration format:
- File permissions must be `0644` (`-rw-r--r--`); migrations are sourced, not executed directly
+Migration format:
 - No shebang line
 - Start with an `echo` describing what the migration does
 - Use `$OMARCHY_PATH` to reference the omarchy directory
- Prefer helper commands such as `omarchy-cmd-present`, `omarchy-cmd-missing`, `omarchy-pkg-present`, and `omarchy-pkg-missing`

-Some older migrations predate these rules. Do not copy older migrations that start with shebangs, omit the leading `echo`, or hard-code `~/.local/share/omarchy`.
+Example:
+```bash
+echo "Disable fingerprint in hyprlock if fingerprint auth is not configured"

-Migrations may use raw `pacman`, `command -v`, or direct config edits when needed for historical compatibility or one-off repair work.
+if omarchy-cmd-missing fprintd-list || ! fprintd-list "$USER" 2>/dev/null | grep -q "finger"; then
+  sed -i 's/fingerprint:enabled = .*/fingerprint:enabled = false/' ~/.config/hypr/hyprlock.conf
+fi
+```
@@ -4,10 +4,6 @@ Omarchy is a beautiful, modern & opinionated Linux distribution by DHH.

 Read more at [omarchy.org](https://omarchy.org).

-## Docs
-
- [omarchy-shell](docs/omarchy-shell.md) — shell host, plugin manifest, IPC, `shell.json`, custom bar modules
-
 ## License

 Omarchy is released under the [MIT License](https://opensource.org/licenses/MIT).
@@ -1,11 +0,0 @@
-[Desktop Entry]
-Type=Application
-Name=Battle.net
-GenericName=Game Launcher
-Comment=Blizzard game launcher (umu-launcher + GE-Proton)
-Exec=omarchy-launch-battlenet
-Icon=Battle.net
-Terminal=false
-Categories=Game;
-StartupNotify=true
-StartupWMClass=battle.net.exe
@@ -1,21 +0,0 @@
-[Desktop Entry]
-Type=Application
-TryExec=foot
-Exec=foot
-Icon=foot
-Terminal=false
-Categories=System;TerminalEmulator;
-Name=Foot
-GenericName=Terminal
-Comment=A fast, lightweight and minimalistic Wayland terminal emulator
-StartupNotify=true
-StartupWMClass=foot
-Actions=New;
-X-TerminalArgExec=-e
-X-TerminalArgAppId=--app-id=
-X-TerminalArgTitle=--title=
-X-TerminalArgDir=--working-directory=
-
-[Desktop Action New]
-Name=New Terminal
-Exec=foot
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -0,0 +1,2 @@
+[Desktop Entry]
+Hidden=true
@@ -1,6 +1,6 @@
 #!/bin/bash

-# omarchy:summary=Returns true if AC power is connected.
+# Returns true if AC power is connected.

 for ac in /sys/class/power_supply/AC* /sys/class/power_supply/ADP*; do
  [[ -r $ac/online && $(cat "$ac/online") == "1" ]] && exit 0
@@ -1,13 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Toggle microphone mute. Drives the hardware mic-mute LED on laptops that expose one.
-
-wpctl set-mute @DEFAULT_AUDIO_SOURCE@ toggle >/dev/null
-
-if wpctl get-volume @DEFAULT_AUDIO_SOURCE@ | grep -q MUTED; then
-  omarchy-brightness-keyboard-mute on
-  omarchy-osd -i microphone-muted -m "Microphone muted"
-else
-  omarchy-brightness-keyboard-mute off
-  omarchy-osd -i microphone -m "Microphone on"
-fi
@@ -1,20 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Set the default audio input and move active streams
-# omarchy:args=<node-id> <source-name>
-# omarchy:examples=omarchy audio input set default 43 alsa_input.pci-0000_00_1f.3.analog-stereo
-
-node_id=${1:-}
-source_name=${2:-}
-
-if [[ -z $node_id || -z $source_name ]]; then
-  echo "Usage: omarchy-audio-input-set-default <node-id> <source-name>" >&2
-  exit 1
-fi
-
-wpctl set-default "$node_id" 2>/dev/null || true
-pactl set-default-source "$source_name" 2>/dev/null || true
-
-pactl list short source-outputs 2>/dev/null | awk '{ print $1 }' | while read -r output; do
-  [[ -n $output ]] && pactl move-source-output "$output" "$source_name" 2>/dev/null || true
-done
@@ -1,20 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Set the default audio output and move active streams
-# omarchy:args=<node-id> <sink-name>
-# omarchy:examples=omarchy audio output set default 42 alsa_output.pci-0000_00_1f.3.analog-stereo
-
-node_id=${1:-}
-sink_name=${2:-}
-
-if [[ -z $node_id || -z $sink_name ]]; then
-  echo "Usage: omarchy-audio-output-set-default <node-id> <sink-name>" >&2
-  exit 1
-fi
-
-timeout 2 wpctl set-default "$node_id" 2>/dev/null || true
-timeout 2 pactl set-default-sink "$sink_name" 2>/dev/null || true
-
-timeout 2 pactl list short sink-inputs 2>/dev/null | awk '{ print $1 }' | while read -r input; do
-  [[ -n $input ]] && timeout 2 pactl move-sink-input "$input" "$sink_name" 2>/dev/null || true
-done
@@ -1,42 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Switch between audio outputs while preserving the mute status
-
-sinks=$(timeout 2 pactl -f json list sinks | jq '[.[] | select((.ports | length == 0) or ([.ports[]? | .availability != "not available"] | any))]')
-sinks_count=$(jq 'length' <<<"$sinks")
-
-if (( sinks_count == 0 )); then
-  omarchy-osd -m "No audio devices found"
-  exit 1
-fi
-
-current_sink_name=$(timeout 2 pactl get-default-sink)
-current_sink_index=$(jq -r --arg name "$current_sink_name" 'map(.name) | index($name)' <<<"$sinks")
-
-if [[ $current_sink_index != "null" ]]; then
-  next_sink_index=$(((current_sink_index + 1) % sinks_count))
-else
-  next_sink_index=0
-fi
-
-next_sink=$(jq -c ".[$next_sink_index]" <<<"$sinks")
-next_sink_name=$(jq -r '.name' <<<"$next_sink")
-next_sink_description=$(jq -r '.description // .properties."device.description" // .name' <<<"$next_sink")
-next_sink_volume=$(jq -r '.volume | to_entries[0].value.value_percent | sub("%"; "") | tonumber' <<<"$next_sink")
-next_sink_is_muted=$(jq -r '.mute' <<<"$next_sink")
-
-if [[ $next_sink_is_muted == "true" ]] || (( next_sink_volume == 0 )); then
-  icon_state="muted"
-elif (( next_sink_volume <= 33 )); then
-  icon_state="low"
-elif (( next_sink_volume <= 66 )); then
-  icon_state="medium"
-else
-  icon_state="high"
-fi
-
-if [[ $next_sink_name != $current_sink_name ]]; then
-  omarchy-audio-output-set-default "$(jq -r '.index' <<<"$next_sink")" "$next_sink_name"
-fi
-
-omarchy-osd -i "volume-${icon_state}" -m "$next_sink_description"
@@ -1,67 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Adjust output volume and show the Omarchy OSD
-# omarchy:args=<raise|lower|mute-toggle|+N|-N>
-# omarchy:examples=omarchy audio output volume raise | omarchy audio output volume lower | omarchy audio output volume mute-toggle | omarchy audio output volume +1
-
-action="${1:-}"
-
-if [[ -z $action ]]; then
-  echo "Usage: omarchy-audio-output-volume <raise|lower|mute-toggle|+N|-N>"
-  exit 1
-fi
-
-volume_state() {
-  wpctl get-volume @DEFAULT_AUDIO_SINK@
-}
-
-volume_percent() {
-  volume_state | awk '{ for (i=1; i<=NF; i++) if ($i ~ /^[0-9.]+$/) print int($i * 100) }'
-}
-
-volume_muted() {
-  volume_state | grep -q MUTED
-}
-
-unmute_output() {
-  wpctl set-mute @DEFAULT_AUDIO_SINK@ 0 >/dev/null
-}
-
-case "$action" in
-  raise) action="+5" ;;
-  lower) action="-5" ;;
-esac
-
-if [[ $action == "mute-toggle" ]]; then
-  runtime_dir="${XDG_RUNTIME_DIR:-/tmp}"
-  debounce_file="$runtime_dir/omarchy-audio-output-volume-mute-toggle.last"
-  now=$(date +%s%3N)
-  last=0
-  [[ -r $debounce_file ]] && read -r last < "$debounce_file" || true
-  if (( now - last < 250 )); then
-    exit 0
-  fi
-  printf '%s\n' "$now" > "$debounce_file"
-
-  wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle >/dev/null
-elif [[ $action == +* ]]; then
-  step="${action#+}"
-  unmute_output
-  wpctl set-volume -l 1.0 @DEFAULT_AUDIO_SINK@ "${step}%+"
-elif [[ $action == -* ]]; then
-  step="${action#-}"
-  unmute_output
-  wpctl set-volume @DEFAULT_AUDIO_SINK@ "${step}%-"
-else
-  echo "Unknown volume action: $action"
-  exit 1
-fi
-
-percent=$(volume_percent)
-if volume_muted || (( percent == 0 )); then
-  icon="volume-muted"
-else
-  icon="volume-high"
-fi
-
-omarchy-osd -i "$icon" -p "$percent"
@@ -1,45 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Print PulseAudio sink availability for the shell
-# omarchy:group=audio
-
-pactl list sinks 2>/dev/null | awk '
-  function emit_sink() {
-    if (name == "") return
-    print name "\t" ((port_count == 0 || available) ? 1 : 0)
-  }
-
-  /^Sink #/ {
-    emit_sink()
-    name = ""
-    in_ports = 0
-    port_count = 0
-    available = 0
-    next
-  }
-
-  /^[[:space:]]*Name:/ {
-    name = $2
-    next
-  }
-
-  /^[[:space:]]*Ports:$/ {
-    in_ports = 1
-    next
-  }
-
-  in_ports && /^\tActive Port:/ {
-    in_ports = 0
-    next
-  }
-
-  in_ports && /^\t\t/ {
-    port_count++
-    if ($0 !~ /not available/) available = 1
-    next
-  }
-
-  END {
-    emit_sink()
-  }
-'
@@ -1,20 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Cycle to the next media source and transfer playback when the current source is playing
-# omarchy:args=[next|previous]
-# omarchy:examples=omarchy audio source switch | omarchy-audio-source-switch previous
-
-direction="${1:-next}"
-
-case "$direction" in
-  next)
-    omarchy-shell media sourceSwitch
-    ;;
-  previous)
-    omarchy-shell media sourceSwitchPrevious
-    ;;
-  *)
-    echo "Usage: omarchy-audio-source-switch [next|previous]" >&2
-    exit 1
-    ;;
-esac
@@ -1,6 +1,7 @@
 #!/bin/bash

-# omarchy:summary=Returns the battery full capacity in Wh (rounded to whole number).
+# Returns the battery full capacity in Wh (rounded to whole number).
+# Used by omarchy-battery-status for displaying battery capacity.

 battery_info=$(upower -i $(upower -e | grep BAT))

@@ -1,17 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Send the low battery warning notification and run battery-low hooks.
-# omarchy:args=<percentage>
-# omarchy:hidden=true
-
-set -euo pipefail
-
-if (($# != 1)); then
-  echo "Usage: omarchy-battery-low <percentage>" >&2
-  exit 1
-fi
-
-level=$1
-
-omarchy-notification-send -g 󱐋 -u critical "Time to recharge!" "Battery is down to ${level}%" -i battery-caution -t 30000
-omarchy-hook battery-low "$level"
@@ -0,0 +1,24 @@
+#!/bin/bash
+
+# Designed to be run by systemd timer every 30 seconds and alerts if battery is low
+
+BATTERY_THRESHOLD=10
+NOTIFICATION_FLAG="/run/user/$UID/omarchy_battery_notified"
+BATTERY_LEVEL=$(omarchy-battery-remaining)
+BATTERY_STATE=$(upower -i $(upower -e | grep 'BAT') | grep -E "state" | awk '{print $2}')
+
+send_notification() {
+  notify-send -u critical "󱐋 Time to recharge!" "Battery is down to ${1}%" -i battery-caution -t 30000
+  omarchy-hook battery-low "$1"
+}
+
+if [[ -n $BATTERY_LEVEL && $BATTERY_LEVEL =~ ^[0-9]+$ ]]; then
+  if [[ $BATTERY_STATE == "discharging" ]] && (( BATTERY_LEVEL <= BATTERY_THRESHOLD )); then
+    if [[ ! -f $NOTIFICATION_FLAG ]]; then
+      send_notification $BATTERY_LEVEL
+      touch $NOTIFICATION_FLAG
+    fi
+  else
+    rm -f $NOTIFICATION_FLAG
+  fi
+fi
@@ -1,6 +1,7 @@
 #!/bin/bash

-# omarchy:summary=Returns true if a battery is present on the system.
+# Returns true if a battery is present on the system.
+# Used by the battery monitor and other battery-related checks.

 for bat in /sys/class/power_supply/BAT*; do
  [[ -r $bat/present ]] &&
@@ -1,6 +1,7 @@
 #!/bin/bash

-# omarchy:summary=Returns the battery percentage remaining as an integer.
+# Returns the battery percentage remaining as an integer.
+# Used by the battery monitor and the Ctrl + Shift + Super + B hotkey.

 upower -i $(upower -e | grep BAT) | awk '/percentage/ { 
    print int($2)
@@ -1,6 +1,6 @@
 #!/bin/bash

-# omarchy:summary=Returns the battery time remaining (to empty or full) in a compact format.
+# Returns the battery time remaining (to empty or full) in a compact format.

 battery_info=$(upower -i $(upower -e | grep BAT))

@@ -1,108 +1,28 @@
 #!/bin/bash

-# omarchy:summary=Returns a formatted battery status string with percentage and power draw/charge.
-# omarchy:args=[--shell]
+# Returns a formatted battery status string with percentage and power draw/charge.
+# Used by the battery notification hotkey (Ctrl + Shift + Super + B).

-shell_output=false
+battery_info=$(upower -i $(upower -e | grep BAT))

-case "${1:-}" in
-  "")
-    ;;
-  --shell)
-    shell_output=true
-    ;;
-  *)
-    echo "Usage: omarchy-battery-status [--shell]" >&2
-    exit 2
-    ;;
-esac
+percentage=$(echo "$battery_info" | awk '/percentage/ {
+    print int($2)
+    exit
+}')

-battery=$(upower -e 2>/dev/null | grep BAT | head -n 1)
-[[ -z $battery ]] && exit 0
+power_rate=$(echo "$battery_info" | awk '/energy-rate/ {
+    rounded = sprintf("%.1f", $2)
+    sub(/\.0$/, "", rounded)
+    print rounded
+    exit
+}')

-battery_info=$(upower -i "$battery")
+state=$(echo "$battery_info" | awk '/state/ { print $2; exit }')
+time_remaining=$(omarchy-battery-remaining-time)
+capacity=$(omarchy-battery-capacity)

-percentage=$(awk '/percentage/ { print int($2); exit }' <<<"$battery_info")
-power_rate_raw=$(awk '/energy-rate/ { print $2; exit }' <<<"$battery_info")
-power_rate=$(awk '/energy-rate/ {
-  rounded = sprintf("%.1f", $2)
-  sub(/\.0$/, "", rounded)
-  print rounded
-  exit
-}' <<<"$battery_info")
-state=$(awk '/state/ { print $2; exit }' <<<"$battery_info")
-time_remaining=$(omarchy-battery-remaining-time 2>/dev/null)
-capacity=$(omarchy-battery-capacity 2>/dev/null)
-threshold_start=$(awk '/charge-start-threshold:/ { gsub(/%/, "", $2); print int($2); exit }' <<<"$battery_info")
-threshold_end=$(awk '/charge-end-threshold:/ { gsub(/%/, "", $2); print int($2); exit }' <<<"$battery_info")
-
-[[ -z $threshold_end ]] && threshold_end=$(cat /sys/class/power_supply/BAT*/charge_control_end_threshold 2>/dev/null | head -1)
-[[ -z $threshold_start ]] && threshold_start=$(cat /sys/class/power_supply/BAT*/charge_control_start_threshold 2>/dev/null | head -1)
-
-ac_online=false
-for supply in /sys/class/power_supply/*; do
-  [[ -r $supply/type ]] || continue
-  [[ $(<"$supply/type") == "Mains" ]] || continue
-  [[ -r $supply/online ]] || continue
-
-  if [[ $(<"$supply/online") == "1" ]]; then
-    ac_online=true
-    break
-  fi
-done
-
-charge_idle=false
-if awk -v rate="${power_rate_raw:-0}" 'BEGIN { exit !(rate <= 0.2) }'; then
-  charge_idle=true
-fi
-
-charge_holding=false
-if [[ $ac_online == "true" && -n $threshold_end ]]; then
-  if [[ $state == "pending-charge" ]]; then
-    charge_holding=true
-  elif [[ $state == "fully-charged" ]] && (( percentage < 99 )); then
-    charge_holding=true
-  elif [[ $state == "charging" && $charge_idle == "true" ]] && (( threshold_end < 99 && percentage >= threshold_end )); then
-    charge_holding=true
-  fi
-fi
-
-if [[ $shell_output == "true" ]]; then
-  printf 'percentage\t%s\n' "${percentage}%"
-  if [[ $charge_holding == "true" ]]; then
-    printf 'state\tholding\n'
-  else
-    printf 'state\t%s\n' "$state"
-  fi
-  printf 'rate\t%s\n' "${power_rate}W"
-  printf 'size\t%s\n' "${capacity}Wh"
-  printf 'time\t%s\n' "$time_remaining"
-
-  cycles=$(cat /sys/class/power_supply/BAT*/cycle_count 2>/dev/null | head -1)
-
-  [[ -n $cycles ]] && printf 'cycles\t%s\n' "$cycles"
-
-  if [[ -n $threshold_end ]]; then
-    if [[ -n $threshold_start && $threshold_start != $threshold_end ]]; then
-      printf 'threshold\t%s-%s%%\n' "$threshold_start" "$threshold_end"
-    else
-      printf 'threshold\t%s%%\n' "$threshold_end"
-    fi
-  fi
-
-  exit 0
-fi
-
-if [[ $charge_holding == "true" ]]; then
-  if [[ -n $threshold_start && $threshold_start != $threshold_end ]]; then
-    threshold_label="${threshold_start}-${threshold_end}%"
-  else
-    threshold_label="${threshold_end}%"
-  fi
-
-  echo "Battery ${percentage}%  ·  Holding at ${threshold_label}  ·  ${power_rate}W / ${capacity}Wh"
-elif [[ $state == "charging" ]]; then
-  echo "Battery ${percentage}%  ·  ${time_remaining} to full  ·   ${power_rate}W / ${capacity}Wh"
+if [[ $state == "charging" ]]; then
+    echo "󰁹    Battery ${percentage}%  ·  ${time_remaining} to full  ·   ${power_rate}W / ${capacity}Wh"
 else
-  echo "Battery ${percentage}%  ·  ${time_remaining} left  ·   ${power_rate}W / ${capacity}Wh"
+    echo "󰁹    Battery ${percentage}%  ·  ${time_remaining} left  ·   ${power_rate}W / ${capacity}Wh"
 fi
@@ -1,50 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Control a Bluetooth device
-# omarchy:group=bluetooth
-# omarchy:args=[pair|connect|disconnect|forget] <address>
-# omarchy:examples=omarchy bluetooth device connect 00:11:22:33:44:55
-
-set -e
-
-usage() {
-  echo "Usage: omarchy-bluetooth-device [pair|connect|disconnect|forget] <address>" >&2
-  exit 1
-}
-
-action=${1:-}
-address=${2:-}
-
-[[ $action == "pair" || $action == "connect" || $action == "disconnect" || $action == "forget" ]] || usage
-[[ $address =~ ^([0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}$ ]] || usage
-
-power_on() {
-  bluetoothctl power on >/dev/null 2>&1 || true
-  sleep 0.5
-}
-
-trust_device() {
-  bluetoothctl trust "$address" >/dev/null 2>&1 || true
-}
-
-case "$action" in
-  pair)
-    power_on
-    timeout 20s bluetoothctl pair "$address" >/dev/null 2>&1 || true
-    trust_device
-    timeout 20s bluetoothctl connect "$address" >/dev/null 2>&1 || true
-    ;;
-  connect)
-    power_on
-    trust_device
-    timeout 20s bluetoothctl connect "$address" >/dev/null 2>&1 || true
-    ;;
-  disconnect)
-    timeout 10s bluetoothctl disconnect "$address" >/dev/null 2>&1 || true
-    ;;
-  forget)
-    power_on
-    timeout 10s bluetoothctl disconnect "$address" >/dev/null 2>&1 || true
-    timeout 10s bluetoothctl remove "$address" >/dev/null 2>&1 || true
-    ;;
-esac
@@ -1,7 +1,6 @@
 #!/bin/bash

-# omarchy:summary=Set the branch for Omarchy's git repository.
-# omarchy:args=<master|rc|dev>
+# Set the branch for Omarchy's git repository.

 if (($# == 0)); then
  echo "Usage: omarchy-branch-set [master|rc|dev]"
@@ -1,30 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Edit, set, or reset About branding
-# omarchy:group=branding
-# omarchy:name=about
-# omarchy:args=<image|text|reset>
-# omarchy:examples=omarchy branding about image | omarchy branding about text | omarchy branding about reset
-
-set -euo pipefail
-
-SOURCE_DIR="${XDG_PICTURES_DIR:-$HOME/Pictures}"
-
-case "${1:-}" in
-image)
-  image=$(omarchy-menu-file "Pick png/svg from $SOURCE_DIR" "${SOURCE_DIR}" "svg png")
-  if [[ -n $image ]] && omarchy-transcode-ascii "$image" ~/.config/omarchy/branding/about.txt --width 54 --height 26; then
-    omarchy-launch-about >/dev/null 2>&1
-  fi
-  ;;
-text)
-  omarchy-launch-editor ~/.config/omarchy/branding/about.txt >/dev/null 2>&1 && omarchy-launch-about >/dev/null 2>&1
-  ;;
-reset)
-  cp "$OMARCHY_PATH/icon.txt" ~/.config/omarchy/branding/about.txt && omarchy-launch-about >/dev/null 2>&1
-  ;;
-*)
-  echo "Usage: omarchy-branding-about <image|text|reset>" >&2
-  exit 1
-  ;;
-esac
@@ -1,30 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Edit, set, or reset screensaver branding
-# omarchy:group=branding
-# omarchy:name=screensaver
-# omarchy:args=<image|text|reset>
-# omarchy:examples=omarchy branding screensaver image | omarchy branding screensaver text | omarchy branding screensaver reset
-
-set -euo pipefail
-
-SOURCE_DIR="${XDG_PICTURES_DIR:-$HOME/Pictures}"
-
-case "${1:-}" in
-image)
-  image=$(omarchy-menu-file "Pick png/svg from $SOURCE_DIR" "${SOURCE_DIR}" "svg png")
-  if [[ -n $image ]] && omarchy-transcode-ascii "$image" ~/.config/omarchy/branding/screensaver.txt; then
-    omarchy-launch-screensaver force >/dev/null 2>&1
-  fi
-  ;;
-text)
-  omarchy-launch-editor ~/.config/omarchy/branding/screensaver.txt >/dev/null 2>&1 && omarchy-launch-screensaver force >/dev/null 2>&1
-  ;;
-reset)
-  cp "$OMARCHY_PATH/logo.txt" ~/.config/omarchy/branding/screensaver.txt && omarchy-launch-screensaver force >/dev/null 2>&1
-  ;;
-*)
-  echo "Usage: omarchy-branding-screensaver <image|text|reset>" >&2
-  exit 1
-  ;;
-esac
@@ -1,92 +1,21 @@
 #!/bin/bash

-# omarchy:summary=Show or adjust brightness on the most likely display device.
-# omarchy:args=[--no-osd] [+N%|N%-|N%|off|on]
-# omarchy:examples=omarchy brightness display | omarchy brightness display +5% | omarchy brightness display --no-osd 50% | omarchy brightness display off | omarchy brightness display on
+# Adjust brightness on the most likely display device.
+# Usage: omarchy-brightness-display <step>

-no_osd=0
-args=()
+step="${1:-+5%}"

-for arg in "$@"; do
-  if [[ $arg == "--no-osd" ]]; then
-    no_osd=1
-  else
-    args+=("$arg")
+# Start with the first possible output, then refine to the most likely given an order heuristic.
+device="$(ls -1 /sys/class/backlight 2>/dev/null | head -n1)"
+for candidate in amdgpu_bl* intel_backlight acpi_video*; do
+  if [[ -e /sys/class/backlight/$candidate ]]; then
+    device="$candidate"
+    break
  fi
 done

-set -- "${args[@]}"
-
-# Get the brightness of the passed display
-display_brightness() {
-  brightnessctl -d "$1" -m 2>/dev/null | awk -F, '{ gsub("%", "", $4); print $4; found=1 } END{ exit !found }'
-}
-
-if (( $# == 0 )); then
-  if omarchy-hyprland-monitor-focused-apple; then
-    omarchy-brightness-display-apple
-    exit
-  fi
-
-  device="$(omarchy-hw-display)" || exit 1
-  display_brightness "$device"
-  exit
-fi
-
-step="$1"
-
-if [[ $step == "off" ]]; then
-  hyprctl dispatch 'hl.dsp.dpms({ action = "disable" })' >/dev/null 2>&1
-  exit 0
-elif [[ $step == "on" ]]; then
-  hyprctl dispatch 'hl.dsp.dpms({ action = "enable" })' >/dev/null 2>&1
-  exit 0
-fi
-
-# Drop overlapping brightness key events so concurrent invocations do not race.
-# Hardware key repeat present on some devices can otherwise glitch OSD rendering.
-exec {lock_fd}>"${XDG_RUNTIME_DIR:-/tmp}/omarchy-brightness-display.lock"
-flock -n "$lock_fd" || exit 0
-
-if omarchy-hyprland-monitor-focused-apple; then
-  if (( no_osd )); then
-    omarchy-brightness-display-apple --no-osd "$step"
-  else
-    omarchy-brightness-display-apple "$step"
-  fi
-  exit
-fi
-
-# Current device highlighted
-device="$(omarchy-hw-display)" || exit 1
-
-# Current brightness percentage
-current=$(display_brightness "$device") || exit 1
-
-# Apply non-uniform step size: 1% steps if at or below 5%, otherwise set an
-# absolute target percentage to avoid raw backlight rounding causing uneven OSD steps.
-if [[ $step == "+5%" ]]; then
-  if (( current < 5 )); then
-    (( target = current + 1 ))
-  else
-    (( target = current + 5 ))
-  fi
-
-  (( target > 100 )) && target=100
-  step="$target%"
-elif [[ $step == "5%-" ]]; then
-  if (( current <= 5 )); then
-    (( target = current - 1 ))
-  else
-    (( target = current - 5 ))
-  fi
-
-  (( target < 1 )) && target=1
-  step="$target%"
-fi
-
-# Set brightness of the display device.
+# Set the actual brightness of the display device.
 brightnessctl -d "$device" set "$step" >/dev/null

-# Show the new brightness in OSD
-(( no_osd )) || omarchy-osd -i brightness -p "$(display_brightness "$device")"
+# Use SwayOSD to display the new brightness setting.
+omarchy-swayosd-brightness "$(brightnessctl -d "$device" -m | cut -d',' -f4 | tr -d '%')"
@@ -1,101 +1,12 @@
 #!/bin/bash

-# omarchy:summary=Show or adjust Apple Studio Display and Apple XDR Display brightness using asdcontrol.
-# omarchy:args=[--no-osd] [+N%|N%-|N%]
-# omarchy:examples=omarchy brightness display apple | omarchy brightness display apple +5% | omarchy brightness display apple --no-osd 50%
-
-device_cache="${XDG_RUNTIME_DIR:-/tmp}/omarchy-brightness-display-apple.device"
-no_osd=0
-args=()
-
-for arg in "$@"; do
-  if [[ $arg == "--no-osd" ]]; then
-    no_osd=1
-  else
-    args+=("$arg")
-  fi
-done
-
-set -- "${args[@]}"
-
-detect_apple_display_device() {
-  local devices=()
-  local path=""
-
-  for path in /dev/usb/hiddev* /dev/hiddev*; do
-    [[ -e $path ]] && devices+=("$path")
-  done
-
-  (( ${#devices[@]} > 0 )) || return 1
-
-  sudo asdcontrol --detect "${devices[@]}" 2>/dev/null | awk -F: '/^\/dev\/(usb\/)?hiddev/{ print $1; exit }'
-}
-
-find_apple_display_device() {
-  local cached=""
-  local device=""
-
-  if [[ -r $device_cache ]]; then
-    read -r cached <"$device_cache" || true
-    if [[ -n $cached && -e $cached ]]; then
-      printf '%s\n' "$cached"
-      return 0
-    fi
-  fi
-
-  device="$(detect_apple_display_device)" || return 1
-  [[ -n $device ]] || return 1
-
-  printf '%s\n' "$device" >"$device_cache"
-  printf '%s\n' "$device"
-}
-
-current_brightness() {
-  local device="$1"
-
-  sudo asdcontrol "$device" 2>/dev/null | awk -F= '
-    /BRIGHTNESS=/ {
-      print int($2 * 100 / 60000)
-      found = 1
-    }
-
-    END { exit !found }
-  '
-}
-
-retry_with_fresh_device() {
-  rm -f "$device_cache"
-  device="$(find_apple_display_device || true)"
-  if [[ -z $device ]]; then
-    echo "No Apple Display HID device found" >&2
-    exit 1
-  fi
-}
-
-device="$(find_apple_display_device || true)"
-if [[ -z $device ]]; then
-  echo "No Apple Display HID device found" >&2
-  exit 1
-fi
+# Adjust the brightness on Apple Studio Displays and Apple XDR Displays using asdcontrol.

 if (( $# == 0 )); then
-  if current_brightness "$device"; then
-    exit
-  else
-    retry_with_fresh_device
-    current_brightness "$device"
-    exit
-  fi
+  echo "Adjust Apple Display Brightness by passing +5000 or -5000 (or any range from 0-60000)"
+else
+  device="$(sudo asdcontrol --detect /dev/usb/hiddev* | grep ^/dev/usb/hiddev | cut -d: -f1)"
+  sudo asdcontrol "$device" -- "$1" >/dev/null
+  value="$(sudo asdcontrol "$device" | awk -F= '/BRIGHTNESS=/{print $2+0}')"
+  omarchy-swayosd-brightness "$(( value * 100 / 60000 ))"
 fi
-
-step="$1"
-if [[ $step =~ ^([0-9]+)%-$ ]]; then
-  step="-${BASH_REMATCH[1]}%"
-fi
-
-if ! sudo asdcontrol "$device" -- "$step" >/dev/null; then
-  retry_with_fresh_device
-  sudo asdcontrol "$device" -- "$step" >/dev/null
-fi
-
-(( no_osd )) || omarchy-osd -i brightness -p "$(current_brightness "$device")"
@@ -1,20 +1,7 @@
 #!/bin/bash

-# omarchy:summary=Adjust keyboard backlight brightness using available steps.
-# omarchy:args=[--no-osd] <up|down|cycle|off|restore>
-
-no_osd=0
-args=()
-
-for arg in "$@"; do
-  if [[ $arg == "--no-osd" ]]; then
-    no_osd=1
-  else
-    args+=("$arg")
-  fi
-done
-
-set -- "${args[@]}"
+# Adjust keyboard backlight brightness using available steps.
+# Usage: omarchy-brightness-keyboard <up|down|cycle>

 direction="${1:-up}"

@@ -32,14 +19,6 @@ if [[ -z $device ]]; then
  exit 1
 fi

-if [[ $direction == "off" ]]; then
-  brightnessctl -sd "$device" set 0 >/dev/null
-  exit 0
-elif [[ $direction == "restore" ]]; then
-  brightnessctl -rd "$device" >/dev/null
-  exit 0
-fi
-
 # Get current and max brightness to determine step size.
 max_brightness="$(brightnessctl -d "$device" max)"
 current_brightness="$(brightnessctl -d "$device" get)"
@@ -62,4 +41,7 @@ fi

 # Set the new brightness.
 brightnessctl -d "$device" set "$new_brightness" >/dev/null
-(( no_osd )) || omarchy-osd -i keyboard -p "$(( new_brightness * 100 / max_brightness ))"
+
+# Use SwayOSD to display the new brightness setting.
+percent=$((new_brightness * 100 / max_brightness))
+omarchy-swayosd-kbd-brightness "$percent"
@@ -1,14 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Set the mic-mute indicator LED on laptops that expose a platform::micmute LED node.
-# omarchy:args=<on|off>
-
-if [[ -e /sys/class/leds/platform::micmute/brightness ]]; then
-  case "$1" in
-    on)  value=1 ;;
-    off) value=0 ;;
-    *)   echo "Usage: $(basename "$0") <on|off>" >&2; exit 1 ;;
-  esac
-
-  brightnessctl --device="platform::micmute" set "$value" >/dev/null 2>&1 || true
-fi
@@ -1,301 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Start or stop screen recording
-# omarchy:group=capture
-# omarchy:args=[--fullscreen] [--with-desktop-audio] [--with-microphone-audio] [--with-webcam] [--webcam-device=<device>] [--resolution=<size>] [--stop-recording]
-# omarchy:examples=omarchy screenrecord | omarchy capture screenrecord --with-desktop-audio
-# omarchy:aliases=omarchy screenrecord
-#
-# Env: OMARCHY_SCREENRECORD_USE_PORTAL=true skips the built-in slurp picker and
-# uses gpu-screen-recorder's xdg-desktop-portal capture backend instead. The
-# portal backend was originally added (PR #3401) for HDR-aware capture, support
-# for monitors driven by external GPUs, and window capture — enable it if any
-# of those matter to you. Off by default because the portal path can fail EGL
-# DMA-BUF modifier import on some configurations, leaving recording unable to
-# start.
-#
-# Env: OMARCHY_SCREENRECORD_DEBUG=true appends gpu-screen-recorder's stderr (and
-# the picker target it was launched with) to /tmp/omarchy-screenrecord.log so
-# users can attach a log when reporting capture failures.
-
-[[ -f ~/.config/user-dirs.dirs ]] && source ~/.config/user-dirs.dirs
-OUTPUT_DIR="${OMARCHY_SCREENRECORD_DIR:-${XDG_VIDEOS_DIR:-$HOME/Videos}}"
-
-if [[ ! -d $OUTPUT_DIR ]]; then
-  notify-send "Screen recording directory does not exist: $OUTPUT_DIR" -u critical -t 3000
-  exit 1
-fi
-
-DESKTOP_AUDIO="false"
-MICROPHONE_AUDIO="false"
-WEBCAM="false"
-WEBCAM_DEVICE=""
-RESOLUTION=""
-FULLSCREEN="false"
-STOP_RECORDING="false"
-RECORDING_FILE="/tmp/omarchy-screenrecord-filename"
-LOG_FILE=$([[ ${OMARCHY_SCREENRECORD_DEBUG:-false} == "true" ]] && echo "/tmp/omarchy-screenrecord.log" || echo "/dev/null")
-
-for arg in "$@"; do
-  case "$arg" in
-  --with-desktop-audio) DESKTOP_AUDIO="true" ;;
-  --with-microphone-audio) MICROPHONE_AUDIO="true" ;;
-  --with-webcam) WEBCAM="true" ;;
-  --webcam-device=*) WEBCAM_DEVICE="${arg#*=}" ;;
-  --resolution=*) RESOLUTION="${arg#*=}" ;;
-  --fullscreen) FULLSCREEN="true" ;;
-  --stop-recording) STOP_RECORDING="true" ;;
-  esac
-done
-
-start_webcam_overlay() {
-  cleanup_webcam
-
-  # Auto-detect first available webcam if none specified
-  if [[ -z $WEBCAM_DEVICE ]]; then
-    WEBCAM_DEVICE=$(v4l2-ctl --list-devices 2>/dev/null | grep -m1 "^[[:space:]]*/dev/video" | tr -d '\t')
-    if [[ -z $WEBCAM_DEVICE ]]; then
-      notify-send "No webcam devices found" -u critical -t 3000
-      return 1
-    fi
-  fi
-
-  # Get monitor scale
-  local scale=$(hyprctl monitors -j | jq -r '.[] | select(.focused == true) | .scale')
-
-  # Target width (base 360px, scaled to monitor)
-  local target_width=$(awk "BEGIN {printf \"%.0f\", 360 * $scale}")
-
-  # Try preferred 16:9 resolutions in order, use first available
-  local preferred_resolutions=("640x360" "1280x720" "1920x1080")
-  local video_size_arg=""
-  local available_formats=$(v4l2-ctl --list-formats-ext -d "$WEBCAM_DEVICE" 2>/dev/null)
-
-  for resolution in "${preferred_resolutions[@]}"; do
-    if echo "$available_formats" | grep -q "$resolution"; then
-      video_size_arg="-video_size $resolution"
-      break
-    fi
-  done
-
-  ffplay -f v4l2 $video_size_arg -framerate 30 "$WEBCAM_DEVICE" \
-    -vf "crop=iw/2:ih,scale=${target_width}:-1" \
-    -window_title "WebcamOverlay" \
-    -noborder \
-    -fflags nobuffer -flags low_delay \
-    -probesize 32 -analyzeduration 0 \
-    -loglevel quiet &
-  sleep 1
-}
-
-cleanup_webcam() {
-  pkill -f "WebcamOverlay" 2>/dev/null
-}
-
-default_resolution() {
-  local width height
-  read -r width height < <(hyprctl monitors -j | jq -r '.[] | select(.focused == true) | "\(.width) \(.height)"')
-  if ((width > 3840 || height > 2160)); then
-    echo "3840x2160"
-  else
-    echo "0x0"
-  fi
-}
-
-# Monitor + window rectangles on the focused workspace, in slurp's "X,Y WxH" format.
-# Mirrors omarchy-capture-screenshot so the picker UX is identical.
-get_rectangles() {
-  local active_workspace=$(hyprctl monitors -j | jq -r '.[] | select(.focused == true) | .activeWorkspace.id')
-  hyprctl monitors -j | jq -r --arg ws "$active_workspace" '
-    .[] | select(.activeWorkspace.id == ($ws | tonumber)) |
-    "\(.x),\(.y) \(.width / .scale | floor)x\(.height / .scale | floor)"'
-  hyprctl clients -j | jq -r --arg ws "$active_workspace" '
-    .[] | select(.workspace.id == ($ws | tonumber)) |
-    "\(.at[0]),\(.at[1]) \(.size[0])x\(.size[1])"'
-}
-
-# Echoes "monitor:NAME" when the selection matches an entire monitor, otherwise
-# "region:WxH+X+Y" with physical-pixel coordinates ready for gpu-screen-recorder.
-# Returns non-zero if the user cancelled the picker.
-select_capture_target() {
-  local rects=$(get_rectangles)
-  hyprpicker -r -z >/dev/null 2>&1 &
-  local picker_pid=$!
-  sleep .1
-  local selection=$(echo "$rects" | slurp 2>/dev/null)
-  kill $picker_pid 2>/dev/null
-
-  # X and Y can be negative (Hyprland monitor positions in multi-display layouts);
-  # widths and heights are always positive.
-  [[ $selection =~ ^(-?[0-9]+),(-?[0-9]+)[[:space:]]([0-9]+)x([0-9]+)$ ]] || return 1
-  local sx=${BASH_REMATCH[1]} sy=${BASH_REMATCH[2]}
-  local sw=${BASH_REMATCH[3]} sh=${BASH_REMATCH[4]}
-
-  # A bare click (area < 20px²) snaps to whichever rectangle the click landed
-  # inside, so users don't end up with accidental 2px recordings.
-  if ((sw * sh < 20)); then
-    while IFS= read -r rect; do
-      [[ $rect =~ ^(-?[0-9]+),(-?[0-9]+)[[:space:]]([0-9]+)x([0-9]+)$ ]] || continue
-      local rx=${BASH_REMATCH[1]} ry=${BASH_REMATCH[2]}
-      local rw=${BASH_REMATCH[3]} rh=${BASH_REMATCH[4]}
-      if ((sx >= rx && sx < rx + rw && sy >= ry && sy < ry + rh)); then
-        sx=$rx sy=$ry sw=$rw sh=$rh
-        break
-      fi
-    done <<<"$rects"
-  fi
-
-  # When the selection exactly matches a monitor, prefer -w <monitor> over a
-  # region capture — same kms backend, but no scaling math and full native res.
-  local monitor=$(hyprctl monitors -j | jq -r --argjson x "$sx" --argjson y "$sy" --argjson w "$sw" --argjson h "$sh" '
-    .[] | select(.x == $x and .y == $y and (.width / .scale | floor) == $w and (.height / .scale | floor) == $h) | .name' | head -1)
-
-  if [[ -n $monitor ]]; then
-    echo "monitor:$monitor"
-    return
-  fi
-
-  # gpu-screen-recorder wants region geometry in the compositor's logical
-  # coordinate space — same space slurp returns — so pass the values through
-  # untouched. (gsr scales to physical pixels itself based on the monitor.)
-  echo "region:${sw}x${sh}+${sx}+${sy}"
-}
-
-start_screenrecording() {
-  local capture_args=()
-  local target
-
-  # Opt-in path for HDR, external-GPU monitors, and window capture (all things
-  # the portal backend supports and the kms backend doesn't). Default flow uses
-  # slurp + the kms backend, which avoids the EGL DMA-BUF modifier import
-  # failures the portal path can hit on some configurations.
-  if [[ $FULLSCREEN == "true" ]]; then
-    target="monitor:$(omarchy-hyprland-monitor-focused)"
-    capture_args=(-w "${target#monitor:}" -s "${RESOLUTION:-$(default_resolution)}")
-  elif [[ ${OMARCHY_SCREENRECORD_USE_PORTAL:-false} == "true" ]]; then
-    target="portal"
-    capture_args=(-w portal -s "${RESOLUTION:-$(default_resolution)}")
-  else
-    target=$(select_capture_target) || return 1
-
-    case $target in
-    monitor:*)
-      capture_args=(-w "${target#monitor:}" -s "${RESOLUTION:-$(default_resolution)}")
-      ;;
-    region:*)
-      capture_args=(-w "${target#region:}")
-      [[ -n $RESOLUTION ]] && capture_args+=(-s "$RESOLUTION")
-      ;;
-    esac
-  fi
-
-  [[ $WEBCAM == "true" ]] && start_webcam_overlay
-
-  local filename="$OUTPUT_DIR/screenrecording-$(date +'%Y-%m-%d_%H-%M-%S').mp4"
-  local audio_devices=""
-  local audio_args=()
-
-  [[ $DESKTOP_AUDIO == "true" ]] && audio_devices+="default_output"
-
-  if [[ $MICROPHONE_AUDIO == "true" ]]; then
-    # Merge audio tracks into one - separate tracks only play one at a time in most players
-    [[ -n $audio_devices ]] && audio_devices+="|"
-    audio_devices+="default_input"
-  fi
-
-  [[ -n $audio_devices ]] && audio_args+=(-a "$audio_devices" -ac aac)
-
-  echo "===== $(date '+%F %T') args: $* target: $target =====" >>"$LOG_FILE"
-  gpu-screen-recorder "${capture_args[@]}" -k auto -f 60 -fm cfr -fallback-cpu-encoding yes -o "$filename" "${audio_args[@]}" 2>>"$LOG_FILE" &
-  local pid=$!
-
-  while kill -0 $pid 2>/dev/null && [[ ! -f $filename ]]; do
-    sleep 0.2
-  done
-
-  if kill -0 $pid 2>/dev/null; then
-    echo "$filename" >"$RECORDING_FILE"
-    toggle_screenrecording_indicator
-  fi
-}
-
-stop_screenrecording() {
-  pkill -SIGINT -f "^gpu-screen-recorder" # SIGINT required to save video properly
-
-  # Wait a maximum of 5 seconds to finish before hard killing
-  local count=0
-  while pgrep -f "^gpu-screen-recorder" >/dev/null && ((count < 50)); do
-    sleep 0.1
-    count=$((count + 1))
-  done
-
-  toggle_screenrecording_indicator
-  cleanup_webcam
-
-  if pgrep -f "^gpu-screen-recorder" >/dev/null; then
-    pkill -9 -f "^gpu-screen-recorder"
-    notify-send "Screen recording error" "Recording process had to be force-killed. Video may be corrupted." -u critical -t 5000
-  else
-    finalize_recording
-    local filename=$(cat "$RECORDING_FILE" 2>/dev/null)
-    echo "$filename"
-    local preview="${filename%.mp4}-preview.png"
-
-    # Generate a preview thumbnail from the first frame
-    ffmpeg -y -i "$filename" -ss 00:00:00.1 -vframes 1 -q:v 2 "$preview" -loglevel quiet 2>/dev/null
-
-    (
-      if [[ -n $(omarchy-notification-send "Screen recording saved" "Open with Super + Alt + , (or click this)" -t 10000 --image "${preview:-$filename}" -a) ]]; then
-        mpv "$filename"
-      fi
-      rm -f "$preview"
-    ) &
-  fi
-
-  rm -f "$RECORDING_FILE"
-}
-
-toggle_screenrecording_indicator() {
-  omarchy-shell -q Indicators refresh
-}
-
-screenrecording_active() {
-  pgrep -f "^gpu-screen-recorder" >/dev/null
-}
-
-finalize_recording() {
-  local latest
-  latest=$(cat "$RECORDING_FILE" 2>/dev/null)
-  [[ -f $latest ]] || return
-
-  # Re-encode only when the first GOP contains discardable warmup packets — stream copy can't
-  # trim those (it rewinds to the keyframe). Clean recordings stay on the fast stream-copy path.
-  local video_codec=(-c:v copy)
-  if ffprobe -v error -select_streams v:0 -read_intervals %+0.2 -show_entries packet=flags -of csv=p=0 "$latest" 2>/dev/null | grep -q D; then
-    video_codec=(-c:v libx264 -preset veryfast -crf 20)
-  fi
-
-  # Trim the first frame, and normalize audio to -14 LUFS if present, in a single pass
-  local args=(-y -ss 0.1 -i "$latest" "${video_codec[@]}")
-  if ffprobe -v error -select_streams a -show_entries stream=codec_type -of csv=p=0 "$latest" 2>/dev/null | grep -q audio; then
-    # Hard-mute the first 400ms to drop the PipeWire capture-open pop (a near-clipping
-    # transient around 130-200ms that a gentle fade-in can't attenuate enough), then a
-    # 50ms fade avoids a click at the boundary before loudnorm normalizes the rest.
-    args+=(-af "volume=enable='lt(t,0.4)':volume=0,afade=t=in:st=0.4:d=0.05,loudnorm=I=-14:TP=-1.5:LRA=11")
-  fi
-
-  local processed="${latest%.mp4}-processed.mp4"
-  if ffmpeg "${args[@]}" "$processed" -loglevel quiet 2>/dev/null; then
-    mv "$processed" "$latest"
-  else
-    rm -f "$processed"
-  fi
-}
-
-if screenrecording_active; then
-  stop_screenrecording
-elif [[ $STOP_RECORDING == "true" ]]; then
-  exit 1
-else
-  start_screenrecording || cleanup_webcam
-fi
@@ -1,35 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Pick a webcam and start a screen recording with it
-# omarchy:examples=omarchy capture screenrecording-with-webcam
-
-set -o pipefail
-
-webcam_list() {
-  v4l2-ctl --list-devices 2>/dev/null | while IFS= read -r line; do
-    if [[ $line != $'\t'* && -n $line ]]; then
-      local name="$line"
-      local device
-      IFS= read -r device || break
-      device=$(tr -d '\t' <<<"$device" | head -1)
-      [[ -n $device ]] && echo "$device  $name"
-    fi
-  done
-}
-
-mapfile -t devices < <(webcam_list)
-if (( ${#devices[@]} == 0 )); then
-  omarchy-notification-send "No webcam devices found" -u critical -t 3000
-  exit 1
-fi
-
-if (( ${#devices[@]} == 1 )); then
-  device="${devices[0]%%[[:space:]]*}"
-else
-  selection=$(omarchy-menu-select "Select Webcam" "${devices[@]}" -- --width 520 --maxheight 520) || exit 1
-  device="${selection%%[[:space:]]*}"
-fi
-
-exec omarchy-capture-screenrecording \
-  --with-desktop-audio --with-microphone-audio \
-  --with-webcam --webcam-device="$device"
@@ -1,26 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Extract text from a screenshot region with OCR
-# omarchy:group=capture
-# omarchy:examples=omarchy capture ocr
-
-# Keep hyprpicker alive until after grim captures so the screenshot sees the
-# frozen overlay rather than live content shifting during teardown.
-cleanup_freeze() {
-  [[ -n $PID ]] && kill $PID 2>/dev/null
-}
-trap cleanup_freeze EXIT
-
-hyprpicker -r -z >/dev/null 2>&1 &
-PID=$!
-sleep .1
-SELECTION=$(slurp 2>/dev/null)
-
-[[ -z $SELECTION ]] && exit 0
-
-TEXT=$(grim -g "$SELECTION" - | tesseract stdin stdout --oem 1 --psm 6 -l "${OMARCHY_OCR_LANGS:-eng}" --dpi 300 -c preserve_interword_spaces=1 2>/dev/null) || exit 1
-
-[[ -z $TEXT ]] && exit 1
-
-printf "%s" "$TEXT" | wl-copy
-omarchy-notification-send -g 󰴑 "Copied text from selection to clipboard"
@@ -1,8 +1,17 @@
 #!/bin/bash

-# omarchy:summary=Set the Omarchy channel, which dictates what git branch and package repository is used.
-# omarchy:args=<stable|rc|edge|dev>
-# omarchy:requires-sudo=true
+# Set the Omarchy channel, which dictates what git branch and package repository is used.
+#
+# Stable uses the master branch, which only sees updates on official releases, and
+# the stable package repository, which typically lags the edge by a month to ensure
+# better compatibility.
+#
+# Edge tracks the latest package repository, but still relies on the master branch,
+# so new packages which require config changes may cause conflicts or errors.
+#
+# Dev tracks the active development dev branch, which may include partial or broken updates,
+# as well as the latest package repository. This should only be used by Omarchy developers
+# and people with a lot of experience managing Linux systems.

 if (($# == 0)); then
  echo "Usage: omarchy-channel-set [stable|rc|edge|dev]"
@@ -1,136 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Native messaging host: download the URL sent by the yt-dlp Chromium extension
-# omarchy:hidden=true
-
-set -euo pipefail
-
-SCRIPT_PATH="${BASH_SOURCE[0]}"
-
-# The browser launches us without Omarchy's environment, so locate the repo from
-# our own path when OMARCHY_PATH isn't already set. Export it — omarchy-shell (used
-# by omarchy-osd) needs it to find the running shell, and silently no-ops without it.
-export OMARCHY_PATH="${OMARCHY_PATH:-$(cd -- "$(dirname -- "$SCRIPT_PATH")/.." && pwd)}"
-
-# Make sure the Omarchy bin and yt-dlp are reachable when launched by the browser.
-export PATH="$OMARCHY_PATH/bin:/usr/local/bin:/usr/bin:$PATH"
-
-DOWNLOAD_DIR="${OMARCHY_YTDLP_DIR:-$HOME/Videos}"
-
-parse_url() {
-  jq -r '.url // empty' 2>/dev/null <<<"$1" || true
-}
-
-valid_url() {
-  [[ $1 =~ ^https?:// ]]
-}
-
-# Drive the Quickshell OSD — a single overlay that updates in place (like the
-# volume/brightness bar), so download progress never stacks like notifications.
-osd_progress() {
-  omarchy-osd -i 󰇚 -p "$1" -d 8000 >/dev/null 2>&1 || true
-}
-
-osd_close() {
-  omarchy-shell -q osd close >/dev/null 2>&1 || true
-}
-
-download_url() {
-  local url="$1"
-
-  mkdir -p "$DOWNLOAD_DIR"
-
-  # Don't show anything until yt-dlp confirms there's actually a video to grab.
-  if ! yt-dlp --no-playlist --simulate --quiet --no-warnings "$url" >/dev/null 2>&1; then
-    omarchy-notification-send -u critical -g 󰅖 "No video found for download" "$url"
-    exit 0
-  fi
-
-  osd_progress 0
-
-  # Stream the download: OMARCHY_PROG carries the percent (drives the OSD),
-  # OMARCHY_FILE (printed only after a successful move) carries title + path.
-  local line rest pct intpct last="" er nowms lastms=0 title="" filepath=""
-  while IFS= read -r line; do
-    case $line in
-    OMARCHY_PROG*)
-      pct=${line#OMARCHY_PROG$'\t'}
-      intpct=${pct%%.*}
-      intpct=${intpct//[^0-9]/}
-      [[ -n $intpct && $intpct != "$last" ]] || continue # skip no-op repeats
-      # Throttle to ~4 redraws/sec so fast downloads don't spawn a flurry of processes.
-      er=$EPOCHREALTIME
-      nowms=$((${er%[.,]*} * 1000 + 10#${er##*[.,]} / 1000))
-      ((nowms - lastms >= 250)) || continue
-      last=$intpct
-      lastms=$nowms
-      osd_progress "$intpct"
-      ;;
-    OMARCHY_FILE*)
-      rest=${line#OMARCHY_FILE$'\t'}
-      title=${rest%%$'\t'*}
-      filepath=${rest#*$'\t'}
-      ;;
-    esac
-  done < <(PYTHONUNBUFFERED=1 yt-dlp --no-playlist --restrict-filenames --no-simulate \
-    --quiet --no-warnings --progress --newline \
-    --progress-template $'download:OMARCHY_PROG\t%(progress._percent_str)s' \
-    --paths "$DOWNLOAD_DIR" -o '%(title)s [%(id)s].%(ext)s' \
-    --print $'after_move:OMARCHY_FILE\t%(title)s\t%(filepath)s' \
-    "$url" 2>&1)
-
-  osd_close
-
-  # after_move only prints on a successful download+move, so a captured path == success.
-  if [[ -n $filepath ]]; then
-    ((${#title} > 50)) && title="${title:0:50}…" # keep the toast compact
-
-    # Square, center-cropped thumbnail so the notification preview isn't stretched.
-    local preview
-    preview="$(mktemp --suffix=.jpg)"
-    ffmpeg -y -i "$filepath" -ss 00:00:00.1 -vframes 1 \
-      -vf "crop='min(iw,ih)':'min(iw,ih)',scale=256:256" -q:v 2 \
-      "$preview" -loglevel quiet 2>/dev/null || true
-
-    # Clicking the toast opens the video in mpv (-a blocks until clicked or timed out).
-    (
-      if [[ -n $(omarchy-notification-send -g 󰄬 "Download complete" "$title" -t 10000 --image "${preview:-$filepath}" -a) ]]; then
-        mpv "$filepath"
-      fi
-      rm -f "$preview"
-    ) &
-  else
-    omarchy-notification-send -u critical -g 󰅖 "Download failed" "$url"
-  fi
-
-  exit 0
-}
-
-main() {
-  local length payload url
-
-  # Detached worker: this is what actually runs yt-dlp and fires notifications.
-  if [[ "${1:-}" == "--download" ]]; then
-    download_url "$2"
-  fi
-
-  # Native messaging frame: 4-byte little-endian length prefix, then UTF-8 JSON.
-  length=$(head -c4 | od -An -v -tu4 --endian=little | tr -d ' ')
-  [[ -n ${length:-} ]] && ((length > 0)) || exit 0
-
-  payload=$(head -c "$length")
-
-  # Ack with an empty message so the extension's sendNativeMessage callback resolves cleanly.
-  printf '\x02\x00\x00\x00{}'
-
-  url=$(parse_url "$payload")
-  [[ -n $url ]] || exit 0
-  valid_url "$url" || exit 0
-
-  # Detach the download so this host exits promptly and frees the browser's port.
-  setsid -f "$SCRIPT_PATH" --download "$url" </dev/null >/dev/null 2>&1
-}
-
-if [[ ${BASH_SOURCE[0]} == "$0" ]]; then
-  main "$@"
-fi
@@ -1,69 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Open a clipboard history entry
-# omarchy:group=clipboard
-# omarchy:args=--history-index <index>
-
-history_index=""
-history_path="$HOME/.local/state/omarchy/clipboard-history.json"
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --history-index)
-      history_index="${2:-}"
-      shift 2
-      ;;
-    *)
-      echo "Usage: omarchy-clipboard-open --history-index <index>" >&2
-      exit 1
-      ;;
-  esac
-done
-
-[[ $history_index =~ ^[0-9]+$ ]] || exit 1
-[[ -r $history_path ]] || exit 1
-
-entry_type=$(jq -er --argjson index "$history_index" '.[$index].type' "$history_path") || exit 1
-
-open_image() {
-  local path="$1"
-
-  [[ -r $path ]] || exit 1
-  exec satty --filename "$path" --output-filename "$path"
-}
-
-open_text() {
-  local text="$1"
-  local url=""
-  local open_dir=""
-  local open_file=""
-
-  url=$(grep -Eom1 'https?://[^[:space:]"'\''<>]+' <<<"$text" || true)
-  if [[ -z $url && $text =~ ^[[:space:]]*([[:alnum:]][[:alnum:].-]+\.[[:alpha:]]{2,})(/[^[:space:]]*)?[[:space:]]*$ ]]; then
-    url="https://${BASH_REMATCH[1]}${BASH_REMATCH[2]}"
-  fi
-
-  if [[ -n $url ]]; then
-    exec omarchy-launch-browser "$url"
-  fi
-
-  open_dir="${XDG_STATE_HOME:-$HOME/.local/state}/omarchy/clipboard-open"
-  mkdir -p "$open_dir"
-  open_file=$(mktemp --tmpdir="$open_dir" clipboard.XXXXXX.txt) || exit 1
-  printf '%s' "$text" >"$open_file"
-  exec omarchy-launch-editor "$open_file"
-}
-
-case "$entry_type" in
-  image)
-    path=$(jq -er --argjson index "$history_index" '.[$index].path' "$history_path") || exit 1
-    open_image "$path"
-    ;;
-  text)
-    text=$(jq -er --argjson index "$history_index" '.[$index].text' "$history_path") || exit 1
-    open_text "$text"
-    ;;
-  *)
-    exit 1
-    ;;
-esac
@@ -1,32 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Copy a file to the clipboard and paste it
-# omarchy:group=clipboard
-# omarchy:args=[--copy-only] <mime-type> <path>
-# omarchy:examples=omarchy clipboard paste file image/png /tmp/screenshot.png
-
-copy_only=false
-
-if [[ ${1:-} == "--copy-only" ]]; then
-  copy_only=true
-  shift
-fi
-
-mime=${1:-}
-path=${2:-}
-
-if [[ -z $mime || -z $path ]]; then
-  echo "Usage: omarchy-clipboard-paste-file [--copy-only] <mime-type> <path>" >&2
-  exit 1
-fi
-
-[[ -r $path ]] || exit 1
-
-wl-copy --type "$mime" < "$path"
-
-if [[ $copy_only == "true" ]]; then
-  exit
-fi
-
-sleep 0.15
-wtype -M shift -k Insert -m shift 2>/dev/null || true
@@ -1,62 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Copy text to the clipboard and type or paste it
-# omarchy:group=clipboard
-# omarchy:args=[--shift-insert] [--copy-only] [--history-index <index>|<text>]
-# omarchy:examples=omarchy clipboard paste text "hello" | omarchy clipboard paste text --shift-insert "hello"
-
-use_shift_insert=false
-copy_only=false
-history_index=""
-text=""
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --shift-insert)
-      use_shift_insert=true
-      shift
-      ;;
-    --copy-only)
-      copy_only=true
-      shift
-      ;;
-    --history-index)
-      history_index="${2:-}"
-      shift 2
-      ;;
-    *)
-      break
-      ;;
-  esac
-done
-
-copy_history_entry() {
-  local history_path="$HOME/.local/state/omarchy/clipboard-history.json"
-
-  [[ $history_index =~ ^[0-9]+$ ]] || exit
-  jq -e --argjson index "$history_index" '.[$index].type == "text" and (.[$index].text | type == "string")' "$history_path" >/dev/null || exit
-  jq -j --argjson index "$history_index" '.[$index].text' "$history_path" | wl-copy
-}
-
-if [[ -n $history_index ]]; then
-  copy_history_entry
-  if [[ $copy_only != "true" ]]; then
-    use_shift_insert=true
-  fi
-else
-  text=${1:-}
-  [[ -n $text ]] || exit
-  printf '%s' "$text" | wl-copy
-fi
-
-if [[ $copy_only == "true" ]]; then
-  exit
-fi
-
-sleep 0.15
-
-if [[ $use_shift_insert == "true" ]]; then
-  wtype -M shift -k Insert -m shift 2>/dev/null || true
-else
-  wtype "$text" 2>/dev/null || true
-fi
@@ -0,0 +1,66 @@
+#!/bin/bash
+
+# Switch between audio outputs while preserving the mute status. By default mapped to Super + Mute.
+
+focused_monitor=$(omarchy-hyprland-monitor-focused)
+
+sinks=$(pactl -f json list sinks | jq '[.[] | select((.ports | length == 0) or ([.ports[]? | .availability != "not available"] | any))]')
+sinks_count=$(echo "$sinks" | jq '. | length')
+
+if (( sinks_count == 0 )); then
+  swayosd-client \
+    --monitor "$focused_monitor" \
+    --custom-message "No audio devices found"
+  exit 1
+fi
+
+current_sink_name=$(pactl get-default-sink)
+current_sink_index=$(echo "$sinks" | jq -r --arg name "$current_sink_name" 'map(.name) | index($name)')
+
+if [[ $current_sink_index != "null" ]]; then
+  next_sink_index=$(((current_sink_index + 1) % sinks_count))
+else
+  next_sink_index=0
+fi
+
+next_sink=$(echo "$sinks" | jq -r ".[$next_sink_index]")
+next_sink_name=$(echo "$next_sink" | jq -r '.name')
+
+next_sink_description=$(echo "$next_sink" | jq -r '.description')
+if [[ $next_sink_description == "(null)" ]] || [[ $next_sink_description == "null" ]] || [[ -z $next_sink_description ]]; then
+  # For Bluetooth devices, the friendly name is on the Device entry (device.id), not the Sink entry (object.id)
+  device_id=$(echo "$next_sink" | jq -r '.properties."device.id"')
+  if [[ $device_id != "null" ]] && [[ -n $device_id ]]; then
+    next_sink_description=$(wpctl status | grep -E "^\s*│?\s+${device_id}\." | sed -E 's/^.*[0-9]+\.\s+//' | sed -E 's/\s+\[.*$//')
+  fi
+  # Fall back to object.id lookup if device.id didn't yield a result
+  if [[ -z $next_sink_description ]]; then
+    sink_id=$(echo "$next_sink" | jq -r '.properties."object.id"')
+    next_sink_description=$(wpctl status | grep -E "\s+\*?\s+${sink_id}\." | sed -E 's/^.*[0-9]+\.\s+//' | sed -E 's/\s+\[.*$//')
+  fi
+fi
+
+next_sink_volume=$(echo "$next_sink" | jq -r \
+  '.volume | to_entries[0].value.value_percent | sub("%"; "")')
+next_sink_is_muted=$(echo "$next_sink" | jq -r '.mute')
+
+if [[ $next_sink_is_muted = "true" ]] || (( next_sink_volume == 0 )); then
+  icon_state="muted"
+elif (( next_sink_volume <= 33 )); then
+  icon_state="low"
+elif (( next_sink_volume <= 66 )); then
+  icon_state="medium"
+else
+  icon_state="high"
+fi
+
+next_sink_volume_icon="sink-volume-${icon_state}-symbolic"
+
+if [[ $next_sink_name != $current_sink_name ]]; then
+  pactl set-default-sink "$next_sink_name"
+fi
+
+swayosd-client \
+  --monitor "$focused_monitor" \
+  --custom-message "$next_sink_description" \
+  --custom-icon "$next_sink_volume_icon"
@@ -1,7 +1,6 @@
 #!/bin/bash

-# omarchy:summary=Finish the installation of Omarchy with items that can only be done after logging in.
-# omarchy:requires-sudo=true
+# Finish the installation of Omarchy with items that can only be done after logging in.

 set -e

@@ -10,15 +9,13 @@ FIRST_RUN_MODE=~/.local/state/omarchy/first-run.mode
 if [[ -f $FIRST_RUN_MODE ]]; then
  rm -f "$FIRST_RUN_MODE"

-  bash "$OMARCHY_PATH/install/first-run/recover-internal-monitor.sh"
+  bash "$OMARCHY_PATH/install/first-run/battery-monitor.sh"
  bash "$OMARCHY_PATH/install/first-run/cleanup-reboot-sudoers.sh"
  bash "$OMARCHY_PATH/install/first-run/firewall.sh"
  bash "$OMARCHY_PATH/install/first-run/dns-resolver.sh"
  bash "$OMARCHY_PATH/install/first-run/gnome-theme.sh"
-  bash "$OMARCHY_PATH/install/first-run/gdk-scale.sh"
-  bash "$OMARCHY_PATH/install/first-run/gtk-primary-paste.sh"
-  omarchy-hook-install post-update "$OMARCHY_PATH/install/first-run/install-voxtype.hook"
-  sudo /bin/rm -f /etc/sudoers.d/first-run
+  bash "$OMARCHY_PATH/install/first-run/elephant.sh"
+  sudo rm -f /etc/sudoers.d/first-run

  bash "$OMARCHY_PATH/install/first-run/welcome.sh"
  bash "$OMARCHY_PATH/install/first-run/wifi.sh"
@@ -0,0 +1,9 @@
+#!/bin/bash
+
+# Toggle microphone mute. Dell XPS systems get special handling for the hardware LED.
+
+if omarchy-hw-match "XPS"; then
+  omarchy-cmd-mic-mute-xps
+else
+  swayosd-client --monitor "$(omarchy-hyprland-monitor-focused)" --input-volume mute-toggle
+fi
@@ -0,0 +1,44 @@
+#!/bin/bash
+
+# Toggle microphone mute on Dell XPS systems. Uses wpctl for reliable toggling
+# and syncs the ALSA capture switch so the hardware mic mute LED follows state.
+
+wpctl set-mute @DEFAULT_AUDIO_SOURCE@ toggle >/dev/null
+
+if pactl get-source-mute @DEFAULT_SOURCE@ | rg -q 'yes'; then
+  alsa_value='off,off'
+  osd_message='Microphone muted'
+  osd_icon='microphone-sensitivity-muted-symbolic'
+else
+  alsa_value='on,on'
+  osd_message='Microphone on'
+  osd_icon='audio-input-microphone-symbolic'
+fi
+
+if [[ -e /sys/class/leds/platform::micmute/brightness ]]; then
+  default_source=$(pactl get-default-source)
+  alsa_card=$(pactl -f json list sources | jq -r --arg source "$default_source" '
+    .[] | select(.name == $source) |
+    .properties["alsa.card"] // .properties["api.alsa.card"] // .properties["api.alsa.pcm.card"] // empty
+  ' | head -1)
+
+  if [[ -n $alsa_card ]]; then
+    cards=("$alsa_card")
+  else
+    mapfile -t cards < <(compgen -G '/proc/asound/card*' | rg -o 'card[0-9]+' | sed 's/card//' | sort -u)
+  fi
+
+  for card in "${cards[@]}"; do
+    while IFS= read -r control; do
+      if [[ $control != *"Jack Microphone"* ]]; then
+        amixer -c "$card" cset "$control" "$alsa_value" >/dev/null 2>&1 || true
+        break 2
+      fi
+    done < <(amixer -c "$card" controls 2>/dev/null | rg -o "name='[^']*Microphone Capture Switch'")
+  done
+fi
+
+swayosd-client \
+  --monitor "$(omarchy-hyprland-monitor-focused)" \
+  --custom-message "$osd_message" \
+  --custom-icon "$osd_icon"
@@ -1,6 +1,6 @@
 #!/bin/bash

-# omarchy:summary=Check whether any required commands are missing
+# Returns true if any of the commands passed in as arguments are missing on the system.

 for cmd in "$@"; do
  if ! command -v "$cmd" &>/dev/null; then
@@ -1,6 +1,6 @@
 #!/bin/bash

-# omarchy:summary=Check whether all required commands are available
+# Returns true if all the commands passed in as arguments exit on the system.

 for cmd in "$@"; do
  command -v "$cmd" &>/dev/null || exit 1
@@ -0,0 +1,184 @@
+#!/bin/bash
+
+# Start and stop a screenrecording, which will be saved to ~/Videos by default.
+# Alternative location can be set via OMARCHY_SCREENRECORD_DIR or XDG_VIDEOS_DIR ENVs.
+# Resolution is capped to 4K for monitors above 4K, native otherwise.
+# Override via --resolution= (e.g. --resolution=1920x1080, --resolution=0x0 for native).
+
+[[ -f ~/.config/user-dirs.dirs ]] && source ~/.config/user-dirs.dirs
+OUTPUT_DIR="${OMARCHY_SCREENRECORD_DIR:-${XDG_VIDEOS_DIR:-$HOME/Videos}}"
+
+if [[ ! -d $OUTPUT_DIR ]]; then
+  notify-send "Screen recording directory does not exist: $OUTPUT_DIR" -u critical -t 3000
+  exit 1
+fi
+
+DESKTOP_AUDIO="false"
+MICROPHONE_AUDIO="false"
+WEBCAM="false"
+WEBCAM_DEVICE=""
+RESOLUTION=""
+STOP_RECORDING="false"
+RECORDING_FILE="/tmp/omarchy-screenrecord-filename"
+
+for arg in "$@"; do
+  case "$arg" in
+  --with-desktop-audio) DESKTOP_AUDIO="true" ;;
+  --with-microphone-audio) MICROPHONE_AUDIO="true" ;;
+  --with-webcam) WEBCAM="true" ;;
+  --webcam-device=*) WEBCAM_DEVICE="${arg#*=}" ;;
+  --resolution=*) RESOLUTION="${arg#*=}" ;;
+  --stop-recording) STOP_RECORDING="true" ;;
+  esac
+done
+
+start_webcam_overlay() {
+  cleanup_webcam
+
+  # Auto-detect first available webcam if none specified
+  if [[ -z $WEBCAM_DEVICE ]]; then
+    WEBCAM_DEVICE=$(v4l2-ctl --list-devices 2>/dev/null | grep -m1 "^[[:space:]]*/dev/video" | tr -d '\t')
+    if [[ -z $WEBCAM_DEVICE ]]; then
+      notify-send "No webcam devices found" -u critical -t 3000
+      return 1
+    fi
+  fi
+
+  # Get monitor scale
+  local scale=$(hyprctl monitors -j | jq -r '.[] | select(.focused == true) | .scale')
+
+  # Target width (base 360px, scaled to monitor)
+  local target_width=$(awk "BEGIN {printf \"%.0f\", 360 * $scale}")
+
+  # Try preferred 16:9 resolutions in order, use first available
+  local preferred_resolutions=("640x360" "1280x720" "1920x1080")
+  local video_size_arg=""
+  local available_formats=$(v4l2-ctl --list-formats-ext -d "$WEBCAM_DEVICE" 2>/dev/null)
+
+  for resolution in "${preferred_resolutions[@]}"; do
+    if echo "$available_formats" | grep -q "$resolution"; then
+      video_size_arg="-video_size $resolution"
+      break
+    fi
+  done
+
+  ffplay -f v4l2 $video_size_arg -framerate 30 "$WEBCAM_DEVICE" \
+    -vf "crop=iw/2:ih,scale=${target_width}:-1" \
+    -window_title "WebcamOverlay" \
+    -noborder \
+    -fflags nobuffer -flags low_delay \
+    -probesize 32 -analyzeduration 0 \
+    -loglevel quiet &
+  sleep 1
+}
+
+cleanup_webcam() {
+  pkill -f "WebcamOverlay" 2>/dev/null
+}
+
+default_resolution() {
+  local width height
+  read -r width height < <(hyprctl monitors -j | jq -r '.[] | select(.focused == true) | "\(.width) \(.height)"')
+  if ((width > 3840 || height > 2160)); then
+    echo "3840x2160"
+  else
+    echo "0x0"
+  fi
+}
+
+start_screenrecording() {
+  local filename="$OUTPUT_DIR/screenrecording-$(date +'%Y-%m-%d_%H-%M-%S').mp4"
+  local audio_devices=""
+  local audio_args=()
+
+  [[ $DESKTOP_AUDIO == "true" ]] && audio_devices+="default_output"
+
+  if [[ $MICROPHONE_AUDIO == "true" ]]; then
+    # Merge audio tracks into one - separate tracks only play one at a time in most players
+    [[ -n $audio_devices ]] && audio_devices+="|"
+    audio_devices+="default_input"
+  fi
+
+  [[ -n $audio_devices ]] && audio_args+=(-a "$audio_devices" -ac aac)
+
+  local resolution="${RESOLUTION:-$(default_resolution)}"
+
+  gpu-screen-recorder -w portal -k auto -s "$resolution" -f 60 -fm cfr -fallback-cpu-encoding yes -o "$filename" "${audio_args[@]}" &
+  local pid=$!
+
+  # Wait for recording to actually start (file appears after portal selection)
+  while kill -0 $pid 2>/dev/null && [[ ! -f $filename ]]; do
+    sleep 0.2
+  done
+
+  if kill -0 $pid 2>/dev/null; then
+    echo "$filename" >"$RECORDING_FILE"
+    toggle_screenrecording_indicator
+  fi
+}
+
+stop_screenrecording() {
+  pkill -SIGINT -f "^gpu-screen-recorder" # SIGINT required to save video properly
+
+  # Wait a maximum of 5 seconds to finish before hard killing
+  local count=0
+  while pgrep -f "^gpu-screen-recorder" >/dev/null && ((count < 50)); do
+    sleep 0.1
+    count=$((count + 1))
+  done
+
+  toggle_screenrecording_indicator
+  cleanup_webcam
+
+  if pgrep -f "^gpu-screen-recorder" >/dev/null; then
+    pkill -9 -f "^gpu-screen-recorder"
+    notify-send "Screen recording error" "Recording process had to be force-killed. Video may be corrupted." -u critical -t 5000
+  else
+    trim_first_frame
+    local filename=$(cat "$RECORDING_FILE" 2>/dev/null)
+    local preview="${filename%.mp4}-preview.png"
+
+    # Generate a preview thumbnail from the first frame
+    ffmpeg -y -i "$filename" -ss 00:00:00.1 -vframes 1 -q:v 2 "$preview" -loglevel quiet 2>/dev/null
+
+    (
+      ACTION=$(notify-send "Screen recording saved" "Open with Super + Alt + , (or click this)" -t 10000 -i "${preview:-$filename}" -A "default=open")
+      [[ $ACTION == "default" ]] && mpv "$filename"
+      rm -f "$preview"
+    ) &
+  fi
+
+  rm -f "$RECORDING_FILE"
+}
+
+toggle_screenrecording_indicator() {
+  pkill -RTMIN+8 waybar
+}
+
+screenrecording_active() {
+  pgrep -f "^gpu-screen-recorder" >/dev/null
+}
+
+trim_first_frame() {
+  local latest
+  latest=$(cat "$RECORDING_FILE" 2>/dev/null)
+
+  if [[ -n $latest && -f $latest ]]; then
+    local trimmed="${latest%.mp4}-trimmed.mp4"
+    if ffmpeg -y -ss 0.1 -i "$latest" -c copy "$trimmed" -loglevel quiet 2>/dev/null; then
+      mv "$trimmed" "$latest"
+    else
+      rm -f "$trimmed"
+    fi
+  fi
+}
+
+if screenrecording_active; then
+  stop_screenrecording
+elif [[ $STOP_RECORDING == "true" ]]; then
+  exit 1
+else
+  [[ $WEBCAM == "true" ]] && start_webcam_overlay
+
+  start_screenrecording || cleanup_webcam
+fi
@@ -1,15 +1,15 @@
 #!/bin/bash

-# omarchy:summary=Run the Omarchy screensaver using random effects from TTE.
+# Run the Omarchy screensaver using random effects from TTE.

 screensaver_in_focus() {
  hyprctl activewindow -j | jq -e '.class == "org.omarchy.screensaver"' >/dev/null 2>&1
 }

 exit_screensaver() {
-  hyprctl eval 'hl.config({ cursor = { invisible = false } })' &>/dev/null || hyprctl keyword cursor:invisible false &>/dev/null || true
+  hyprctl keyword cursor:invisible false &>/dev/null || true
  pkill -x tte 2>/dev/null
-  pkill -f '[o]rg.omarchy.screensaver' 2>/dev/null
+  pkill -f org.omarchy.screensaver 2>/dev/null
  exit 0
 }

@@ -18,14 +18,15 @@ trap exit_screensaver SIGINT SIGTERM SIGHUP SIGQUIT

 printf '\033]11;rgb:00/00/00\007'  # Set background color to black

-hyprctl eval 'hl.config({ cursor = { invisible = true } })' &>/dev/null || hyprctl keyword cursor:invisible true &>/dev/null
+hyprctl keyword cursor:invisible true &>/dev/null

 tty=$(tty 2>/dev/null)

 while true; do
  tte -i ~/.config/omarchy/branding/screensaver.txt \
    --frame-rate 120 --canvas-width 0 --canvas-height 0 --reuse-canvas --anchor-canvas c --anchor-text c\
-    --random-effect --no-eol --no-restore-cursor &
+    --random-effect --exclude-effects dev_worm \
+    --no-eol --no-restore-cursor &

  while pgrep -t "${tty#/dev/}" -x tte >/dev/null; do
    if read -n1 -t 1 || ! screensaver_in_focus; then
@@ -1,17 +1,15 @@
 #!/bin/bash

-# omarchy:summary=Take a screenshot
-# omarchy:group=capture
-# omarchy:args=[smart|region|windows|fullscreen] [slurp|copy|save] [--editor=<name>]
-# omarchy:examples=omarchy screenshot | omarchy capture screenshot region
-# omarchy:aliases=omarchy screenshot
+# Take a screenshot of the whole screen, a specific window, or a user-drawn region.
+# Saves to ~/Pictures by default, but that can be changed via OMARCHY_SCREENSHOT_DIR or XDG_PICTURES_DIR ENVs.
+# Editor defaults to Satty but can be changed via --editor=<name> or OMARCHY_SCREENSHOT_EDITOR env

 [[ -f ~/.config/user-dirs.dirs ]] && source ~/.config/user-dirs.dirs
 OUTPUT_DIR="${OMARCHY_SCREENSHOT_DIR:-${XDG_PICTURES_DIR:-$HOME/Pictures}}"

 if [[ ! -d $OUTPUT_DIR ]]; then
  mkdir -p "$OUTPUT_DIR"
-  omarchy-notification-send "Created screenshot directory: $OUTPUT_DIR" -t 2000
+  notify-send "Created screenshot directory: $OUTPUT_DIR" -u normal -t 2000
 fi

 pkill slurp && exit 0
@@ -36,7 +34,7 @@ open_editor() {
      --output-filename "$filepath" \
      --actions-on-enter save-to-clipboard \
      --save-after-copy \
-      --copy-command 'wl-copy --type image/png'
+      --copy-command 'wl-copy'
  else
    $SCREENSHOT_EDITOR "$filepath"
  fi
@@ -65,13 +63,6 @@ get_rectangles() {
  hyprctl clients -j | jq -r --arg ws "$active_workspace" '.[] | select(.workspace.id == ($ws | tonumber)) | "\(.at[0]),\(.at[1]) \(.size[0])x\(.size[1])"'
 }

-# Keep hyprpicker alive until after grim captures so the screenshot sees the
-# frozen overlay rather than live content shifting during teardown.
-cleanup_freeze() {
-  [[ -n $PID ]] && kill $PID 2>/dev/null
-}
-trap cleanup_freeze EXIT
-
 # Select based on mode
 case "$MODE" in
 region)
@@ -79,12 +70,14 @@ region)
  PID=$!
  sleep .1
  SELECTION=$(slurp 2>/dev/null)
+  kill $PID 2>/dev/null
  ;;
 windows)
  hyprpicker -r -z >/dev/null 2>&1 &
  PID=$!
  sleep .1
  SELECTION=$(get_rectangles | slurp -r 2>/dev/null)
+  kill $PID 2>/dev/null
  ;;
 fullscreen)
  SELECTION=$(hyprctl monitors -j | jq -r "${JQ_MONITOR_GEO} .[] | select(.focused == true) | format_geo")
@@ -95,6 +88,7 @@ smart | *)
  PID=$!
  sleep .1
  SELECTION=$(echo "$RECTS" | slurp 2>/dev/null)
+  kill $PID 2>/dev/null

  # If the selection area is L * W < 20, we'll assume you were trying to select whichever
  # window or output it was inside of to prevent accidental 2px snapshots
@@ -126,23 +120,14 @@ esac
 FILENAME="screenshot-$(date +'%Y-%m-%d_%H-%M-%S').png"
 FILEPATH="$OUTPUT_DIR/$FILENAME"

-case "$PROCESSING" in
-  slurp)
-    grim -g "$SELECTION" "$FILEPATH" || exit 1
-    echo "$FILEPATH"
-    wl-copy --type image/png <"$FILEPATH"
+if [[ $PROCESSING == "slurp" ]]; then
+  grim -g "$SELECTION" "$FILEPATH" || exit 1
+  wl-copy <"$FILEPATH"

-    (
-      if [[ -n $(omarchy-notification-send "Screenshot saved to clipboard and file" "Edit with Super + Alt + , (or click this)" -t 10000 --image "$FILEPATH" -a) ]]; then
-        open_editor "$FILEPATH"
-      fi
-    ) >/dev/null 2>&1 &
-    ;;
-  copy)
-    grim -g "$SELECTION" - | wl-copy --type image/png
-    ;;
-  save)
-    grim -g "$SELECTION" "$FILEPATH" || exit 1
-    echo "$FILEPATH"
-    ;;
-esac
+  (
+    ACTION=$(notify-send "Screenshot saved to clipboard and file" "Edit with Super + Alt + , (or click this)" -t 10000 -i "$FILEPATH" -A "default=edit")
+    [[ $ACTION == "default" ]] && open_editor "$FILEPATH"
+  ) &
+else
+  grim -g "$SELECTION" - | wl-copy
+fi
@@ -1,13 +1,9 @@
 #!/bin/bash

-# omarchy:summary=Share clipboard, files, or folders with LocalSend
-# omarchy:group=share
-# omarchy:name=
-# omarchy:args=<clipboard|file|folder> [path...]
-# omarchy:examples=omarchy share clipboard | omarchy share file ~/Downloads/example.txt
+# Share clipboard, file, or folder using LocalSend. Bound to Super + Ctrl + S by default.

 if (($# == 0)); then
-  echo "Usage: omarchy-menu-share [clipboard|file|folder]"
+  echo "Usage: omarchy-cmd-share [clipboard|file|folder]"
  exit 1
 fi

@@ -1,8 +1,9 @@
 #!/bin/bash

-# omarchy:summary=Print the current working directory of the active terminal window
-# omarchy:hidden=true
+# Returns the current working directory of the active terminal window,
+# so a new terminal window can be started in the same directory.

+# Go from current active terminal to its child shell process and run cwd there
 terminal_pid=$(hyprctl activewindow | awk '/pid:/ {print $2}')
 shell_pid=$(pgrep -P "$terminal_pid" | tail -n1)

@@ -1,7 +1,7 @@
 #!/bin/bash

-# omarchy:summary=Add or remove an EFI boot entry for the Omarchy UKI, allowing the system to boot directly
-# omarchy:requires-sudo=true
+# Add an EFI boot entry for the Omarchy UKI, allowing the system to boot directly
+# without a bootloader like Limine. Requires UEFI firmware and a built UKI.

 if [[ ! -d /sys/firmware/efi ]]; then
  echo "Error: System is not booted in UEFI mode" >&2
@@ -23,36 +23,23 @@ if cat /sys/class/dmi/id/bios_vendor 2>/dev/null | grep -qi "Apple"; then
  exit 1
 fi

-existing_entry=$(efibootmgr | grep -E "^Boot[0-9A-Fa-f]+\*? Omarchy([[:space:]]|$)" | head -1)
+uki_file=$(find /boot/EFI/Linux/ -name "omarchy*.efi" -printf "%f\n" 2>/dev/null | head -1)

-if [[ -n $existing_entry ]]; then
-  boot_num=$(echo "$existing_entry" | sed -n 's/^Boot\([0-9A-Fa-f]\+\).*/\1/p')
-
-  if gum confirm "Disable direct boot (remove Omarchy EFI entry)?"; then
-    echo "Removing EFI boot entry $boot_num"
-    sudo efibootmgr --bootnum "$boot_num" --delete-bootnum >/dev/null
-  fi
-
-  exit 0
-else
-  uki_file=$(find /boot/EFI/Linux/ -name "omarchy*.efi" -printf "%f\n" 2>/dev/null | head -1)
-
-  if [[ -z $uki_file ]]; then
-    echo "Error: No Omarchy UKI found in /boot/EFI/Linux/" >&2
-    exit 1
-  fi
-
-  boot_source=$(findmnt -n -o SOURCE /boot)
-  disk=$(echo "$boot_source" | sed 's/p\?[0-9]*$//')
-  part=$(echo "$boot_source" | grep -o 'p\?[0-9]*$' | sed 's/^p//')
-
-  if gum confirm "Setup direct boot (so snapshot booting must be done via bios)?"; then
-    echo "Creating EFI boot entry for $uki_file"
-
-    sudo efibootmgr --create \
-      --disk "$disk" \
-      --part "$part" \
-      --label "Omarchy" \
-      --loader "\\EFI\\Linux\\$uki_file"
-  fi
+if [[ -z $uki_file ]]; then
+  echo "Error: No Omarchy UKI found in /boot/EFI/Linux/" >&2
+  exit 1
+fi
+
+boot_source=$(findmnt -n -o SOURCE /boot)
+disk=$(echo "$boot_source" | sed 's/p\?[0-9]*$//')
+part=$(echo "$boot_source" | grep -o 'p\?[0-9]*$' | sed 's/^p//')
+
+if gum confirm "Setup direct boot (so snapshot booting must be done via bios)?"; then
+  echo "Creating EFI boot entry for $uki_file"
+
+  sudo efibootmgr --create \
+    --disk "$disk" \
+    --part "$part" \
+    --label "Omarchy" \
+    --loader "\\EFI\\Linux\\$uki_file"
 fi
@@ -1,615 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Mutate the user shell.json bar layout and active bar option
-# omarchy:args=show | options [--json] | use <plugin> | reset | list [--json] [--all] | add [plugin] [left|center|right] | remove [plugin] | drop [plugin] | position <top|bottom|left|right> | transparent <true|false>
-# omarchy:examples=omarchy config shell bar show | omarchy config shell bar options | omarchy config shell bar use local.neon-bar | omarchy config shell bar reset | omarchy config shell bar list | omarchy config shell bar add omarchy.tailscale | omarchy config shell bar position top | omarchy config shell bar transparent true
-
-set -euo pipefail
-
-CONFIG_FILE="$HOME/.config/omarchy/shell.json"
-OMARCHY_ROOT="${OMARCHY_PATH:-}"
-DEFAULTS_FILE="$OMARCHY_ROOT/config/omarchy/shell.json"
-
-usage() {
-  echo "Usage: omarchy-config-shell-bar show | options [--json] | use <plugin> | reset | list [--json] [--all] | add [plugin] [left|center|right] | remove [plugin] | drop [plugin] | position <top|bottom|left|right> | transparent <true|false>" >&2
-}
-
-fail() {
-  echo "omarchy-config-shell-bar: $*" >&2
-  exit 1
-}
-
-refresh_shell_config() {
-  if ! omarchy-shell shell reloadConfig >/dev/null 2>&1; then
-    omarchy-shell -q shell rescanPlugins >/dev/null 2>&1 || true
-  fi
-}
-
-source_file() {
-  local source="$CONFIG_FILE"
-
-  if [[ ! -s $source ]]; then
-    [[ -n $OMARCHY_ROOT ]] || fail "OMARCHY_PATH is not set"
-    source="$DEFAULTS_FILE"
-  fi
-
-  [[ -s $source ]] || fail "could not find shell config or defaults"
-  printf '%s\n' "$source"
-}
-
-bar_widget_manifest_paths() {
-  {
-    if [[ -n $OMARCHY_ROOT && -d $OMARCHY_ROOT/shell/plugins ]]; then
-      find "$OMARCHY_ROOT/shell/plugins" -mindepth 2 -maxdepth 4 -type f \( -name manifest.json -o -name '*.manifest.json' \) 2>/dev/null
-    fi
-
-    if [[ -d $HOME/.config/omarchy/plugins ]]; then
-      find -L "$HOME/.config/omarchy/plugins" -mindepth 2 -maxdepth 2 -type f -name manifest.json 2>/dev/null
-    fi
-  } | sort -u
-}
-
-bar_option_manifest_paths() {
-  {
-    if [[ -n $OMARCHY_ROOT && -d $OMARCHY_ROOT/shell/plugins ]]; then
-      find "$OMARCHY_ROOT/shell/plugins" -mindepth 2 -maxdepth 4 -type f \( -name manifest.json -o -name '*.manifest.json' \) 2>/dev/null
-    fi
-
-    if [[ -d $HOME/.config/omarchy/plugins ]]; then
-      find -L "$HOME/.config/omarchy/plugins" -mindepth 2 -maxdepth 2 -type f -name manifest.json 2>/dev/null
-    fi
-  } | sort -u
-}
-
-current_bar_option_id() {
-  jq -r '(.bar.id // "omarchy.bar") | tostring' "$(source_file)"
-}
-
-available_bar_options_json() {
-  local current_id
-  local manifest_paths=()
-
-  current_id=$(current_bar_option_id)
-  mapfile -t manifest_paths < <(bar_option_manifest_paths)
-
-  if (( ${#manifest_paths[@]} == 0 )); then
-    printf '[]\n'
-    return
-  fi
-
-  jq -s --arg currentId "$current_id" '
-    map(
-      select(((.kinds // []) | index("bar")) and ((.entryPoints.bar // "") != "")) |
-      {
-        id: (.id // ""),
-        name: (.name // .id // ""),
-        description: (.description // ""),
-        firstParty: ((.id // "") | startswith("omarchy.")),
-        active: ((.id // "") == $currentId)
-      } |
-      select(.id != "")
-    ) |
-    unique_by(.id) |
-    sort_by((if .id == "omarchy.bar" then 0 else 1 end), .name, .id)
-  ' "${manifest_paths[@]}"
-}
-
-print_bar_options() {
-  local json="false"
-
-  while (( $# > 0 )); do
-    case "$1" in
-      --json)
-        json="true"
-        ;;
-      -h|--help)
-        usage
-        exit 0
-        ;;
-      *)
-        fail "unknown options option: $1"
-        ;;
-    esac
-    shift
-  done
-
-  if [[ $json == "true" ]]; then
-    available_bar_options_json
-    return
-  fi
-
-  available_bar_options_json | jq -r '
-    .[] |
-    [
-      .id,
-      (if .active then "active" else "available" end),
-      (if .firstParty then "built-in" else "plugin" end),
-      .name,
-      .description
-    ] | @tsv
-  ' | awk -F '\t' '
-    BEGIN { printf "%-32s %-10s %-8s %-22s %s\n", "ID", "STATUS", "SOURCE", "NAME", "DESCRIPTION" }
-    { printf "%-32s %-10s %-8s %-22s %s\n", $1, $2, $3, $4, $5 }
-  '
-}
-
-bar_option_exists() {
-  local id="$1"
-  available_bar_options_json | jq -e --arg id "$id" 'any(.[]; .id == $id)' >/dev/null
-}
-
-current_bar_ids_json() {
-  jq -c '
-    def array_or_empty: if type == "array" then . else [] end;
-    def entry_id: if type == "object" then (.id // "" | tostring) else tostring end;
-
-    ["left", "center", "right"] as $sections |
-    [ $sections[] as $section |
-      ((.bar.layout[$section] // []) | array_or_empty)[] |
-      entry_id |
-      select(length > 0)
-    ]
-  ' "$(source_file)"
-}
-
-current_bar_entries_json() {
-  jq -c '
-    def array_or_empty: if type == "array" then . else [] end;
-    def entry_id($entry): if ($entry | type) == "object" then ($entry.id // "" | tostring) else ($entry | tostring) end;
-
-    ["left", "center", "right"] as $sections |
-    [ $sections[] as $section |
-      ((.bar.layout[$section] // []) | array_or_empty | to_entries[]) |
-      { section: $section, index: .key, id: entry_id(.value) } |
-      select(.id | length > 0)
-    ]
-  ' "$(source_file)"
-}
-
-available_widgets_json() {
-  local include_all="$1"
-  local current_ids
-  local manifest_paths=()
-
-  current_ids=$(current_bar_ids_json)
-  mapfile -t manifest_paths < <(bar_widget_manifest_paths)
-
-  if (( ${#manifest_paths[@]} == 0 )); then
-    printf '[]\n'
-    return
-  fi
-
-  jq -s --argjson currentIds "$current_ids" --argjson includeAll "$include_all" '
-    map(
-      select(((.kinds // []) | index("bar-widget")) and ((.entryPoints.barWidget // "") != "")) |
-      {
-        id: (.id // ""),
-        name: (.barWidget.displayName // .name // .id // ""),
-        description: (.barWidget.description // .description // ""),
-        category: (.barWidget.category // "Plugin"),
-        allowMultiple: (.barWidget.allowMultiple == true)
-      } |
-      select(.id != "")
-    ) |
-    unique_by(.id) |
-    map(. as $widget |
-      $widget + {
-        inBar: (($currentIds | index($widget.id)) != null),
-        addable: ($widget.allowMultiple or (($currentIds | index($widget.id)) == null))
-      }
-    ) |
-    map(select($includeAll or .addable)) |
-    sort_by(.category, .name, .id)
-  ' "${manifest_paths[@]}"
-}
-
-print_available_widgets() {
-  local include_all="false"
-  local json="false"
-
-  while (( $# > 0 )); do
-    case "$1" in
-      --all)
-        include_all="true"
-        ;;
-      --json)
-        json="true"
-        ;;
-      -h|--help)
-        usage
-        exit 0
-        ;;
-      *)
-        fail "unknown list option: $1"
-        ;;
-    esac
-    shift
-  done
-
-  if [[ $json == "true" ]]; then
-    available_widgets_json "$include_all"
-    return
-  fi
-
-  available_widgets_json "$include_all" | jq -r '
-    .[] |
-    [
-      .id,
-      (if .inBar and .allowMultiple then "addable*" elif .inBar then "in-bar" else "addable" end),
-      .category,
-      .name,
-      .description
-    ] | @tsv
-  ' | awk -F '\t' '
-    BEGIN { printf "%-28s %-10s %-14s %-22s %s\n", "ID", "STATUS", "CATEGORY", "NAME", "DESCRIPTION" }
-    { printf "%-28s %-10s %-14s %-22s %s\n", $1, $2, $3, $4, $5 }
-  '
-}
-
-choose_widget() {
-  local widgets
-  local options=()
-  local selected=""
-
-  widgets=$(available_widgets_json false)
-
-  if ! jq -e 'length > 0' <<<"$widgets" >/dev/null; then
-    fail "no addable bar widgets found"
-  fi
-
-  mapfile -t options < <(jq -r '
-    .[] |
-    [.id, .name, .category, .description] | @tsv
-  ' <<<"$widgets" | awk -F '\t' '{ printf "%-28s  %-22s  [%s] %s\n", $1, $2, $3, $4 }')
-
-  if [[ -t 0 || -t 2 ]]; then
-    if omarchy-cmd-present gum; then
-      selected=$(printf '%s\n' "${options[@]}" | gum filter --header "Add bar widget" --placeholder "Search addable widgets..." --limit 1 --height 14) || return 1
-    elif omarchy-cmd-present fzf; then
-      selected=$(printf '%s\n' "${options[@]}" | fzf --prompt "Add bar widget > " --height 40% --layout reverse --border) || return 1
-    else
-      print_available_widgets >&2
-      fail "gum or fzf is required for interactive widget selection"
-    fi
-  else
-    print_available_widgets >&2
-    fail "widget id is required; use list to see addable widgets"
-  fi
-
-  selected="${selected%%[[:space:]]*}"
-  [[ -n $selected ]] || return 1
-  printf '%s\n' "$selected"
-}
-
-choose_removal() {
-  local entries
-  local widgets
-  local options=()
-  local selected=""
-  local location=""
-  local section=""
-  local index=""
-
-  entries=$(current_bar_entries_json)
-  widgets=$(available_widgets_json true)
-
-  if ! jq -e 'length > 0' <<<"$entries" >/dev/null; then
-    fail "no bar widgets are currently configured"
-  fi
-
-  mapfile -t options < <(jq -r --argjson widgets "$widgets" '
-    def widget_meta($id): first($widgets[]? | select(.id == $id)) // {};
-
-    .[] as $entry |
-    (widget_meta($entry.id)) as $meta |
-    [
-      "\($entry.section)[\($entry.index)]",
-      $entry.id,
-      ($meta.name // $entry.id),
-      ($meta.category // "")
-    ] | @tsv
-  ' <<<"$entries" | awk -F '\t' '{ printf "%-10s  %-28s  %-22s  %s\n", $1, $2, $3, $4 }')
-
-  if [[ -t 0 || -t 2 ]]; then
-    if omarchy-cmd-present gum; then
-      selected=$(printf '%s\n' "${options[@]}" | gum filter --header "Remove bar widget" --placeholder "Search current widgets..." --limit 1 --height 14) || return 1
-    elif omarchy-cmd-present fzf; then
-      selected=$(printf '%s\n' "${options[@]}" | fzf --prompt "Remove bar widget > " --height 40% --layout reverse --border) || return 1
-    else
-      jq -r '.[] | "\(.section)[\(.index)]\t\(.id)"' <<<"$entries" >&2
-      fail "gum or fzf is required for interactive widget selection"
-    fi
-  else
-    jq -r '.[] | "\(.section)[\(.index)]\t\(.id)"' <<<"$entries" >&2
-    fail "widget id is required; use show to see current widgets"
-  fi
-
-  location="${selected%%[[:space:]]*}"
-  section="${location%%[*}"
-  index="${location#*[}"
-  index="${index%]}"
-
-  [[ $section =~ ^(left|center|right)$ ]] || return 1
-  [[ $index =~ ^[0-9]+$ ]] || return 1
-  printf '%s\t%s\n' "$section" "$index"
-}
-
-command="${1:-}"
-
-case "$command" in
-  show|current)
-    if (( $# != 1 )); then
-      usage
-      exit 1
-    fi
-
-    jq '.bar // {}' "$(source_file)"
-    ;;
-  selected|active)
-    if (( $# != 1 )); then
-      usage
-      exit 1
-    fi
-
-    current_bar_option_id
-    ;;
-  options|option)
-    shift
-    print_bar_options "$@"
-    ;;
-  use)
-    if (( $# != 2 )); then
-      usage
-      exit 1
-    fi
-
-    plugin="${2:-}"
-    [[ -n $plugin ]] || fail "bar option id is required"
-    if [[ $plugin == "default" || $plugin == "built-in" ]]; then
-      plugin="omarchy.bar"
-    fi
-    bar_option_exists "$plugin" || fail "$plugin is not a known bar option; run 'omarchy config shell bar options'"
-
-    mkdir -p "$(dirname "$CONFIG_FILE")"
-
-    source="$(source_file)"
-    tmp=$(mktemp)
-    trap 'rm -f "$tmp"' EXIT
-
-    if [[ $plugin == "omarchy.bar" ]]; then
-      jq '
-        def object_or_empty: if type == "object" then . else {} end;
-
-        object_or_empty
-        | .version = 1
-        | .bar = (.bar | object_or_empty)
-        | del(.bar.id)
-      ' "$source" >"$tmp"
-    else
-      jq --arg plugin "$plugin" '
-        def object_or_empty: if type == "object" then . else {} end;
-
-        object_or_empty
-        | .version = 1
-        | .bar = (.bar | object_or_empty)
-        | .bar.id = $plugin
-      ' "$source" >"$tmp"
-    fi
-
-    mv "$tmp" "$CONFIG_FILE"
-    trap - EXIT
-    omarchy-shell -q shell rescanPlugins >/dev/null 2>&1 || true
-    refresh_shell_config
-    ;;
-  reset)
-    if (( $# != 1 )); then
-      usage
-      exit 1
-    fi
-
-    mkdir -p "$(dirname "$CONFIG_FILE")"
-
-    source="$(source_file)"
-    tmp=$(mktemp)
-    trap 'rm -f "$tmp"' EXIT
-
-    jq '
-      def object_or_empty: if type == "object" then . else {} end;
-
-      object_or_empty
-      | .version = 1
-      | .bar = (.bar | object_or_empty)
-      | del(.bar.id)
-    ' "$source" >"$tmp"
-
-    mv "$tmp" "$CONFIG_FILE"
-    trap - EXIT
-    refresh_shell_config
-    ;;
-  list|available|widgets)
-    shift
-    print_available_widgets "$@"
-    ;;
-  add)
-    if (( $# > 3 )); then
-      usage
-      exit 1
-    fi
-
-    if (( $# == 1 )); then
-      plugin=$(choose_widget) || exit 1
-    else
-      plugin="${2:-}"
-    fi
-    section="${3:-right}"
-
-    [[ -n $plugin ]] || fail "plugin is required"
-    [[ $section =~ ^(left|center|right)$ ]] || fail "section must be left, center, or right"
-
-    mkdir -p "$(dirname "$CONFIG_FILE")"
-
-    source="$(source_file)"
-    tmp=$(mktemp)
-    trap 'rm -f "$tmp"' EXIT
-
-    jq --arg section "$section" --arg plugin "$plugin" '
-      def object_or_empty: if type == "object" then . else {} end;
-      def array_or_empty: if type == "array" then . else [] end;
-      def entry_id: if type == "object" then (.id // "" | tostring) else tostring end;
-      def append_anchor($section):
-        {
-          left: "omarchy.workspaces",
-          center: "omarchy.weather",
-          right: "omarchy.tray"
-        }[$section];
-      def insert_after_anchor($entries; $entry; $anchor):
-        ($entries | map(entry_id) | index($anchor)) as $index
-        | if $index == null then
-            $entries + [$entry]
-          else
-            $entries[0:$index + 1] + [$entry] + $entries[$index + 1:]
-          end;
-
-      object_or_empty
-      | .version = 1
-      | .bar = (.bar | object_or_empty)
-      | .bar.layout = (.bar.layout | object_or_empty)
-      | .bar.layout.left = (.bar.layout.left | array_or_empty | map(select(entry_id != $plugin)))
-      | .bar.layout.center = (.bar.layout.center | array_or_empty | map(select(entry_id != $plugin)))
-      | .bar.layout.right = (.bar.layout.right | array_or_empty | map(select(entry_id != $plugin)))
-      | .plugins = (.plugins | array_or_empty)
-      | .bar.layout[$section] = insert_after_anchor(.bar.layout[$section]; { id: $plugin }; append_anchor($section))
-    ' "$source" >"$tmp"
-
-    mv "$tmp" "$CONFIG_FILE"
-    trap - EXIT
-    refresh_shell_config
-    ;;
-  position)
-    if (( $# != 2 )); then
-      usage
-      exit 1
-    fi
-
-    position="${2:-}"
-
-    [[ $position =~ ^(top|bottom|left|right)$ ]] || fail "position must be top, bottom, left, or right"
-
-    mkdir -p "$(dirname "$CONFIG_FILE")"
-
-    source="$(source_file)"
-    tmp=$(mktemp)
-    trap 'rm -f "$tmp"' EXIT
-
-    jq --arg position "$position" '
-      def object_or_empty: if type == "object" then . else {} end;
-
-      object_or_empty
-      | .version = 1
-      | .bar = (.bar | object_or_empty)
-      | .bar.position = $position
-    ' "$source" >"$tmp"
-
-    mv "$tmp" "$CONFIG_FILE"
-    trap - EXIT
-    refresh_shell_config
-    ;;
-  transparent)
-    if (( $# != 2 )); then
-      usage
-      exit 1
-    fi
-
-    transparent="${2:-}"
-
-    [[ $transparent =~ ^(true|false)$ ]] || fail "transparent must be true or false"
-
-    mkdir -p "$(dirname "$CONFIG_FILE")"
-
-    source="$(source_file)"
-    tmp=$(mktemp)
-    trap 'rm -f "$tmp"' EXIT
-
-    jq --argjson transparent "$transparent" '
-      def object_or_empty: if type == "object" then . else {} end;
-
-      object_or_empty
-      | .version = 1
-      | .bar = (.bar | object_or_empty)
-      | .bar.transparent = $transparent
-    ' "$source" >"$tmp"
-
-    mv "$tmp" "$CONFIG_FILE"
-    trap - EXIT
-    refresh_shell_config
-    ;;
-  drop|remove|rm)
-    if (( $# > 2 )); then
-      usage
-      exit 1
-    fi
-
-    plugin=""
-    target_section=""
-    target_index=""
-
-    if (( $# == 1 )); then
-      removal=$(choose_removal) || exit 1
-      target_section="${removal%%$'\t'*}"
-      target_index="${removal#*$'\t'}"
-    else
-      plugin="${2:-}"
-      [[ -n $plugin ]] || fail "plugin is required"
-    fi
-
-    mkdir -p "$(dirname "$CONFIG_FILE")"
-
-    source="$(source_file)"
-    tmp=$(mktemp)
-    trap 'rm -f "$tmp"' EXIT
-
-    if [[ -n $target_section ]]; then
-      jq --arg section "$target_section" --argjson index "$target_index" '
-        def object_or_empty: if type == "object" then . else {} end;
-        def array_or_empty: if type == "array" then . else [] end;
-
-        object_or_empty
-        | .version = 1
-        | .bar = (.bar | object_or_empty)
-        | .bar.layout = (.bar.layout | object_or_empty)
-        | .bar.layout.left = (.bar.layout.left | array_or_empty)
-        | .bar.layout.center = (.bar.layout.center | array_or_empty)
-        | .bar.layout.right = (.bar.layout.right | array_or_empty)
-        | if (.bar.layout[$section] | length) <= $index then
-            error("no widget at " + $section + "[" + ($index | tostring) + "]")
-          else
-            .bar.layout[$section] = (.bar.layout[$section][0:$index] + .bar.layout[$section][($index + 1):])
-          end
-        | .plugins = (.plugins | array_or_empty)
-      ' "$source" >"$tmp"
-    else
-      jq --arg plugin "$plugin" '
-        def object_or_empty: if type == "object" then . else {} end;
-        def array_or_empty: if type == "array" then . else [] end;
-        def entry_id: if type == "object" then (.id // "" | tostring) else tostring end;
-
-        object_or_empty
-        | .version = 1
-        | .bar = (.bar | object_or_empty)
-        | .bar.layout = (.bar.layout | object_or_empty)
-        | .bar.layout.left = (.bar.layout.left | array_or_empty | map(select(entry_id != $plugin)))
-        | .bar.layout.center = (.bar.layout.center | array_or_empty | map(select(entry_id != $plugin)))
-        | .bar.layout.right = (.bar.layout.right | array_or_empty | map(select(entry_id != $plugin)))
-        | .plugins = (.plugins | array_or_empty)
-      ' "$source" >"$tmp"
-    fi
-
-    mv "$tmp" "$CONFIG_FILE"
-    trap - EXIT
-    refresh_shell_config
-    ;;
-  *)
-    usage
-    exit 1
-    ;;
-esac
@@ -1,9 +1,6 @@
 #!/bin/bash

-# omarchy:summary=Print debugging information
-# omarchy:args=[--no-sudo] [--print]
-# omarchy:examples=omarchy debug --print --no-sudo
-# omarchy:requires-sudo=true
+# Return exhaustive debugging information about the system to help diagnose problems.

 NO_SUDO=false
 PRINT_ONLY=false
@@ -74,8 +71,8 @@ ACTION=$(gum choose "${OPTIONS[@]}")

 case "$ACTION" in
  "Upload log")
-    echo "Uploading debug log to logs.omarchy.org..."
-    URL=$(curl -sF "file=@$LOG_FILE" -Fexpires=24 https://logs.omarchy.org)
+    echo "Uploading debug log to 0x0.st..."
+    URL=$(curl -sF "file=@$LOG_FILE" -Fexpires=24 https://0x0.st)
    if (( $? == 0 )) && [[ -n $URL ]]; then
      echo "✓ Log uploaded successfully!"
      echo "Share this URL:"
@@ -1,58 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Show idle, screensaver, and lock diagnostics
-# omarchy:group=debug
-# omarchy:args=[log-lines]
-# omarchy:examples=omarchy debug idle | omarchy-debug-idle 400
-
-lines=${1:-200}
-if [[ ! $lines =~ ^[0-9]+$ ]]; then
-  lines=200
-fi
-
-section() {
-  printf '\n== %s ==\n' "$1"
-}
-
-section "Time"
-date -Is
-
-section "Idle IPC status"
-omarchy-shell idle status 2>&1 | jq . 2>/dev/null || omarchy-shell idle status 2>&1 || true
-
-section "Quickshell instances"
-quickshell list -p "$OMARCHY_PATH/shell" --any-display 2>&1 || true
-
-section "Recent idle logs"
-quickshell --no-color log -p "$OMARCHY_PATH/shell" --any-display --tail "$lines" --log-times -r 'quickshell.wayland.idle_notify=true' 2>&1 \
-  | grep -Ei 'omarchy idle|idle_notify|screensaver|lock|error|warn|failed' || true
-
-section "Relevant processes"
-ps -eo pid=,args= \
-  | grep -E 'quickshell -n -p|omarchy-system-sleep-monitor|systemd-inhibit.*Lock screen before suspend|org\.omarchy\.screensaver|omarchy-screensaver|(^|/| )tte( |$)' \
-  | grep -v grep || true
-
-section "Sleep lock service"
-systemctl --user status omarchy-sleep-lock.service --no-pager 2>/dev/null || true
-
-section "Hyprland screensaver clients"
-hyprctl clients -j 2>/dev/null \
-  | jq -r '.[] | select(.class == "org.omarchy.screensaver" or .initialClass == "org.omarchy.screensaver") | [.pid,.class,.initialClass,.title,.focusHistoryID] | @tsv' || true
-
-section "Idle inhibitors"
-hyprctl clients -j 2>/dev/null \
-  | jq -r '.[] | select(.inhibitingIdle == true or ((.tags // []) | index("noidle"))) | [.pid,.class,.title,((.tags // []) | join(",")),.inhibitingIdle] | @tsv' || true
-
-section "Screensaver detector"
-if hyprctl clients -j 2>/dev/null | jq -e '.[] | select(.class == "org.omarchy.screensaver" or .initialClass == "org.omarchy.screensaver")' >/dev/null; then
-  echo "running-window"
-elif pgrep -f '[o]rg.omarchy.screensaver' >/dev/null; then
-  echo "running-process"
-elif omarchy-toggle-enabled screensaver-off; then
-  echo "disabled"
-else
-  echo "stopped"
-fi
-
-section "Lock detector"
-omarchy-shell lock status 2>&1 | jq . 2>/dev/null || omarchy-shell lock status 2>&1 || true
@@ -1,32 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Set the default AI harness used by omarchy-launch-ai
-# omarchy:args=[pi|claude|codex|opencode]
-# omarchy:examples=omarchy default ai | omarchy default ai pi | omarchy default ai claude
-
-ai_file="$HOME/.local/state/omarchy/defaults/ai"
-
-if (( $# == 0 )); then
-  if [[ -f $ai_file ]]; then
-    read -r harness <"$ai_file"
-  fi
-
-  [[ -n ${harness:-} ]] && echo "$harness" || echo "pi"
-  exit 0
-fi
-
-case "$1" in
-pi) harness="pi"; name="Pi"; glyph=󰚩 ;;
-claude) harness="claude"; name="Claude Code"; glyph=󰚩 ;;
-codex) harness="codex"; name="Codex"; glyph=󰚩 ;;
-opencode) harness="opencode"; name="OpenCode"; glyph=󰚩 ;;
-*)
-  echo "Usage: omarchy-default-ai <pi|claude|codex|opencode>" >&2
-  exit 1
-  ;;
-esac
-
-mkdir -p "$(dirname "$ai_file")"
-printf '%s\n' "$harness" >"$ai_file"
-
-omarchy-notification-send -g "$glyph" "$name is now the default AI harness"
@@ -1,40 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Set the default browser for Omarchy and XDG handlers
-# omarchy:args=[chromium|chrome|brave|brave-origin|edge|firefox|zen]
-# omarchy:examples=omarchy default browser firefox | omarchy default browser brave
-
-if (($# == 0)); then
-  case "$(xdg-settings get default-web-browser)" in
-  chromium.desktop) echo "chromium" ;;
-  google-chrome.desktop) echo "chrome" ;;
-  brave-browser.desktop) echo "brave" ;;
-  brave-origin-beta.desktop) echo "brave-origin" ;;
-  microsoft-edge.desktop) echo "edge" ;;
-  firefox.desktop) echo "firefox" ;;
-  zen.desktop) echo "zen" ;;
-  *) xdg-settings get default-web-browser ;;
-  esac
-  exit 0
-fi
-
-case "$1" in
-chromium) desktop_id="chromium.desktop"; name="Chromium"; glyph= ;;
-chrome) desktop_id="google-chrome.desktop"; name="Chrome"; glyph=󰊯 ;;
-brave) desktop_id="brave-browser.desktop"; name="Brave"; glyph=󰖟 ;;
-brave-origin) desktop_id="brave-origin-beta.desktop"; name="Brave Origin"; glyph=󰖟 ;;
-edge) desktop_id="microsoft-edge.desktop"; name="Edge"; glyph=󰇩 ;;
-firefox) desktop_id="firefox.desktop"; name="Firefox"; glyph=󰈹 ;;
-zen) desktop_id="zen.desktop"; name="Zen"; glyph=󰖟 ;;
-*)
-  echo "Usage: omarchy-default-browser <chromium|chrome|brave|brave-origin|edge|firefox|zen>"
-  exit 1
-  ;;
-esac
-
-xdg-settings set default-web-browser "$desktop_id"
-xdg-mime default "$desktop_id" x-scheme-handler/http
-xdg-mime default "$desktop_id" x-scheme-handler/https
-xdg-mime default "$desktop_id" text/html
-
-omarchy-notification-send -g $glyph "$name is now the default browser"
@@ -1,36 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Set the default editor used by omarchy-launch-editor
-# omarchy:args=[code|cursor|zed|sublime_text|helix|vim|emacs|nvim]
-# omarchy:examples=omarchy default editor | omarchy default editor code | omarchy default editor helix
-
-editor_file="$HOME/.local/state/omarchy/defaults/editor"
-
-if (($# == 0)); then
-  if [[ -f $editor_file ]]; then
-    read -r editor <"$editor_file"
-  fi
-
-  [[ -n $editor ]] && echo "$editor" || echo "nvim"
-  exit 0
-fi
-
-case "$1" in
-code) editor="code"; name="VSCode"; glyph= ;;
-cursor) editor="cursor"; name="Cursor"; glyph= ;;
-zed | zeditor) editor="zeditor"; name="Zed"; glyph= ;;
-sublime_text) editor="sublime_text"; name="Sublime Text"; glyph= ;;
-helix) editor="helix"; name="Helix"; glyph= ;;
-vim) editor="vim"; name="Vim"; glyph= ;;
-emacs) editor="emacs"; name="Emacs"; glyph= ;;
-nvim) editor="nvim"; name="Neovim"; glyph= ;;
-*)
-  echo "Usage: omarchy-default-editor <code|cursor|zed|sublime_text|helix|vim|emacs|nvim>"
-  exit 1
-  ;;
-esac
-
-mkdir -p "$(dirname "$editor_file")"
-printf '%s\n' "$editor" >"$editor_file"
-
-omarchy-notification-send -g $glyph "$name is now the default editor"
@@ -1,36 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Set the default terminal used by xdg-terminal-exec
-# omarchy:args=[alacritty|foot|ghostty|kitty]
-# omarchy:examples=omarchy default terminal ghostty | omarchy default terminal kitty
-
-if (($# == 0)); then
-  desktop_id=$(grep -vE '^($|#)' ~/.config/xdg-terminals.list 2>/dev/null | head -n 1)
-  case "$desktop_id" in
-  Alacritty.desktop) echo "alacritty" ;;
-  foot.desktop) echo "foot" ;;
-  com.mitchellh.ghostty.desktop) echo "ghostty" ;;
-  kitty.desktop) echo "kitty" ;;
-  *) echo "$desktop_id" ;;
-  esac
-  exit 0
-fi
-
-case "$1" in
-alacritty) desktop_id="Alacritty.desktop"; name="Alacritty"; glyph= ;;
-foot) desktop_id="foot.desktop"; name="Foot"; glyph= ;;
-ghostty) desktop_id="com.mitchellh.ghostty.desktop"; name="Ghostty"; glyph= ;;
-kitty) desktop_id="kitty.desktop"; name="Kitty"; glyph= ;;
-*)
-  echo "Usage: omarchy-default-terminal <alacritty|foot|ghostty|kitty>"
-  exit 1
-  ;;
-esac
-
-cat >~/.config/xdg-terminals.list <<EOF
-# Terminal emulator preference order for xdg-terminal-exec
-# The first found and valid terminal will be used
-$desktop_id
-EOF
-
-omarchy-notification-send -g $glyph "$name is now the default terminal"
@@ -1,6 +1,7 @@
 #!/bin/bash

-# omarchy:summary=Creates a new Omarchy migration named after the unix timestamp of the last commit.
+# Creates a new Omarchy migration named after the unix timestamp of the last commit.
+# Only intended for Omarchy developers.

 cd ~/.local/share/omarchy
 migration_file="$HOME/.local/share/omarchy/migrations/$(git log -1 --format=%cd --date=unix).sh"
@@ -1,111 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Measure Omarchy CLI response times
-# omarchy:args=[--repeat=<count>]
-# omarchy:examples=omarchy dev benchmark | omarchy dev benchmark --repeat=10
-
-set -euo pipefail
-
-OMARCHY_BIN_DIR=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)
-CLI="$OMARCHY_BIN_DIR/omarchy"
-REPEAT=5
-
-show_help() {
-  cat <<'EOF'
-Usage:
-  omarchy dev benchmark [--repeat=<count>]
-
-Measure response times for common Omarchy CLI surfaces.
-
-Options:
-  --repeat=<count>  Number of times to run each case (default: 5)
-EOF
-}
-
-now_us() {
-  local now="${EPOCHREALTIME/./}"
-  printf '%s' "$now"
-}
-
-format_ms() {
-  local us="$1"
-  printf '%d.%03d' "$(( us / 1000 ))" "$(( us % 1000 ))"
-}
-
-run_case() {
-  local label="$1"
-  shift
-  local total_us=0
-  local min_us=0
-  local max_us=0
-  local elapsed_us=0
-  local start_us=0
-  local end_us=0
-  local status=0
-
-  for (( i = 1; i <= REPEAT; i++ )); do
-    start_us=$(now_us)
-    if "$@" >/dev/null; then
-      status=0
-    else
-      status=$?
-    fi
-    end_us=$(now_us)
-
-    if (( status != 0 )); then
-      printf '%-34s failed (exit %d)\n' "$label" "$status"
-      return "$status"
-    fi
-
-    elapsed_us=$(( end_us - start_us ))
-    total_us=$(( total_us + elapsed_us ))
-
-    if (( i == 1 || elapsed_us < min_us )); then
-      min_us=$elapsed_us
-    fi
-
-    if (( elapsed_us > max_us )); then
-      max_us=$elapsed_us
-    fi
-  done
-
-  printf '%-34s avg %8s ms  min %8s ms  max %8s ms\n' \
-    "$label" \
-    "$(format_ms "$(( total_us / REPEAT ))")" \
-    "$(format_ms "$min_us")" \
-    "$(format_ms "$max_us")"
-}
-
-while (( $# > 0 )); do
-  case "$1" in
-  --repeat=*)
-    REPEAT="${1#*=}"
-    ;;
-  --help | -h)
-    show_help
-    exit 0
-    ;;
-  *)
-    echo "Unknown option: $1" >&2
-    show_help >&2
-    exit 2
-    ;;
-  esac
-  shift
-done
-
-if [[ ! $REPEAT =~ ^[0-9]+$ ]] || (( REPEAT < 1 )); then
-  echo "--repeat must be a positive integer" >&2
-  exit 2
-fi
-
-printf 'Omarchy CLI benchmark (%d runs each)\n\n' "$REPEAT"
-run_case "omarchy" "$CLI"
-run_case "omarchy --help" "$CLI" --help
-run_case "omarchy commands" "$CLI" commands
-run_case "omarchy commands --json" "$CLI" commands --json
-run_case "omarchy commands --all --json" "$CLI" commands --all --json
-run_case "omarchy theme set --help" "$CLI" theme set --help
-run_case "omarchy screenshot --help" "$CLI" screenshot --help
-run_case "omarchy restart --help" "$CLI" restart --help
-run_case "omarchy theme current" "$CLI" theme current
@@ -1,160 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Measure theme switcher cache and selector prep times
-# omarchy:args=[--repeat=<count>] [--keep-cache]
-# omarchy:examples=omarchy dev benchmark theme switcher | omarchy dev benchmark theme-switcher --repeat=10
-# omarchy:aliases=omarchy dev benchmark theme-switcher
-
-set -euo pipefail
-
-OMARCHY_BIN_DIR=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)
-REPEAT=5
-KEEP_CACHE=false
-
-show_help() {
-  cat <<'EOF'
-Usage:
-  omarchy dev benchmark theme switcher [--repeat=<count>] [--keep-cache]
-
-Measure the non-interactive parts of the theme switcher:
- theme preview index build (omarchy-theme-switcher before UI handoff)
- lazy selector row prep used by the interactive theme switcher
- full thumbnail cache warmup cost (omarchy-menu-images --cache-only)
-
-Options:
-  --repeat=<count>  Number of warm runs to measure for each case (default: 5)
-  --keep-cache      Keep the temporary benchmark cache and print its path
-EOF
-}
-
-now_us() {
-  local now="${EPOCHREALTIME/./}"
-  printf '%s' "$now"
-}
-
-format_ms() {
-  local us="$1"
-  printf '%d.%03d' "$(( us / 1000 ))" "$(( us % 1000 ))"
-}
-
-measure_once() {
-  local start_us end_us
-  start_us=$(now_us)
-  "$@" >/dev/null
-  end_us=$(now_us)
-  printf '%s' "$(( end_us - start_us ))"
-}
-
-run_case() {
-  local label="$1"
-  shift
-  local total_us=0
-  local min_us=0
-  local max_us=0
-  local elapsed_us=0
-
-  for (( i = 1; i <= REPEAT; i++ )); do
-    elapsed_us=$(measure_once "$@")
-    total_us=$(( total_us + elapsed_us ))
-
-    if (( i == 1 || elapsed_us < min_us )); then
-      min_us=$elapsed_us
-    fi
-
-    if (( elapsed_us > max_us )); then
-      max_us=$elapsed_us
-    fi
-  done
-
-  printf '%-34s avg %8s ms  min %8s ms  max %8s ms\n' \
-    "$label" \
-    "$(format_ms "$(( total_us / REPEAT ))")" \
-    "$(format_ms "$min_us")" \
-    "$(format_ms "$max_us")"
-}
-
-while (( $# > 0 )); do
-  case "$1" in
-  --repeat=*)
-    REPEAT="${1#*=}"
-    ;;
-  --keep-cache)
-    KEEP_CACHE=true
-    ;;
-  --help | -h)
-    show_help
-    exit 0
-    ;;
-  *)
-    echo "Unknown option: $1" >&2
-    show_help >&2
-    exit 2
-    ;;
-  esac
-  shift
-done
-
-if [[ ! $REPEAT =~ ^[0-9]+$ ]] || (( REPEAT < 1 )); then
-  echo "--repeat must be a positive integer" >&2
-  exit 2
-fi
-
-benchmark_cache=$(mktemp -d)
-thumbnail_cache=$(mktemp -d)
-stub_bin=$(mktemp -d)
-
-cleanup() {
-  rm -rf "$stub_bin"
-
-  if [[ $KEEP_CACHE == "true" ]]; then
-    printf 'Benchmark cache: %s\n' "$benchmark_cache"
-    printf 'Thumbnail cache: %s\n' "$thumbnail_cache"
-  else
-    rm -rf "$benchmark_cache" "$thumbnail_cache"
-  fi
-}
-trap cleanup EXIT
-
-cat >"$stub_bin/omarchy-menu-images" <<'EOF'
-#!/bin/bash
-exit 0
-EOF
-chmod +x "$stub_bin/omarchy-menu-images"
-
-benchmark_env=(
-  env
-  "XDG_CACHE_HOME=$benchmark_cache"
-  "PATH=$stub_bin:$OMARCHY_BIN_DIR:$PATH"
-)
-
-thumbnail_env=(
-  env
-  "XDG_CACHE_HOME=$thumbnail_cache"
-  "PATH=$stub_bin:$OMARCHY_BIN_DIR:$PATH"
-)
-
-preview_dir="$benchmark_cache/omarchy/theme-selector/previews"
-thumbnail_preview_dir="$thumbnail_cache/omarchy/theme-selector/previews"
-
-build_theme_index() {
-  "${benchmark_env[@]}" "$OMARCHY_BIN_DIR/omarchy-theme-switcher"
-}
-
-prepare_selector_lazy() {
-  "${benchmark_env[@]}" "$OMARCHY_BIN_DIR/omarchy-menu-images" --prepare-only --lazy-thumbnails --show-labels --filterable "$preview_dir"
-}
-
-prepare_image_cache() {
-  "${thumbnail_env[@]}" "$OMARCHY_BIN_DIR/omarchy-menu-images" --cache-only "$thumbnail_preview_dir"
-}
-
-printf 'Theme switcher benchmark (%d warm runs each)\n\n' "$REPEAT"
-printf '%-34s %s ms\n' "theme index cold" "$(format_ms "$(measure_once build_theme_index)")"
-run_case "theme index warm" build_theme_index
-printf '%-34s %s ms\n' "selector prep cold (lazy)" "$(format_ms "$(measure_once prepare_selector_lazy)")"
-run_case "selector prep warm (lazy)" prepare_selector_lazy
-"${thumbnail_env[@]}" "$OMARCHY_BIN_DIR/omarchy-theme-switcher" >/dev/null
-printf '%-34s %s ms\n' "thumbnail cache cold" "$(format_ms "$(measure_once prepare_image_cache)")"
-run_case "thumbnail cache warm" prepare_image_cache
-
-printf '\nTheme previews: %d\n' "$(find -L "$preview_dir" -maxdepth 1 -type f 2>/dev/null | wc -l)"
@@ -1,89 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Show Omarchy bin metadata fields and defaults
-# omarchy:args=[--json]
-
-set -euo pipefail
-
-show_json() {
-  jq -n '{
-    ok: true,
-    defaults: {
-      group: "first filename segment after omarchy-",
-      name: "remaining filename segments with dashes converted to spaces",
-      route: "omarchy <group> <name>",
-      binary: "filename",
-      requires_sudo: false
-    },
-    fields: [
-      {name: "summary", required: true, type: "string", note: "One-line human and agent-facing description."},
-      {name: "group", required: false, type: "string", note: "Only set when the route group should differ from the filename-derived group."},
-      {name: "name", required: false, type: "string", note: "Only set when the route name should differ from the filename-derived name. May be empty for root commands."},
-      {name: "args", required: false, type: "string", note: "Only set when the command accepts arguments."},
-      {name: "examples", required: false, type: "string", note: "Pipe-separated examples."},
-      {name: "aliases", required: false, type: "string", note: "Pipe-separated alternate routes, e.g. omarchy screenshot."},
-      {name: "requires-sudo", required: false, type: "true", default: false, note: "Only include when true."},
-      {name: "hidden", required: false, type: "true", default: false, note: "Hide from default command listings; visible with --all."}
-    ]
-  }'
-}
-
-show_help() {
-  cat <<'EOF'
-Omarchy bin metadata
-
-Metadata lives in the top comment block of each executable bin/omarchy-* file.
-Keep it slim: define only fields that are required or override defaults.
-
-Required:
-  # omarchy:summary=<one-line description>
-
-Inferred defaults:
-  group         first filename segment after omarchy-
-  name          remaining filename segments, with dashes converted to spaces
-  route         omarchy <group> <name>
-  binary        filename
-  requires-sudo false
-  hidden        false
-
-Optional fields:
-  # omarchy:group=<group>                  route override only
-  # omarchy:name=<name>                    route override only; may be empty
-  # omarchy:args=<args>                    only if the command accepts args
-  # omarchy:examples=<cmd> | <cmd>         pipe-separated examples
-  # omarchy:aliases=<route> | <route>      pipe-separated alternate routes
-  # omarchy:requires-sudo=true             only when true
-  # omarchy:hidden=true                    hide from default command listings
-
-Do not define:
-  binary      inferred from filename
-  usage       derived from route + args
-  false flags or empty args
-
-Examples:
-  # omarchy:summary=Restart the shell
-
-  # omarchy:summary=Take a screenshot
-  # omarchy:group=capture
-  # omarchy:args=[smart|region|windows|fullscreen] [slurp|copy] [--editor=<name>]
-  # omarchy:examples=omarchy screenshot | omarchy capture screenshot region
-  # omarchy:aliases=omarchy screenshot
-EOF
-}
-
-case "${1:-}" in
--json)
-  show_json
-  ;;
--help | -h)
-  show_help
-  ;;
-"")
-  show_help
-  ;;
-*)
-  echo "Unknown option: $1" >&2
-  show_help >&2
-  exit 2
-  ;;
-esac
@@ -1,50 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Install and enable ydotool mouse automation for Omarchy development
-# omarchy:requires-sudo=true
-
-set -euo pipefail
-
-RULE_FILE="/etc/udev/rules.d/80-uinput.rules"
-
-if ! getent group input >/dev/null; then
-  echo "omarchy-dev-install-ydoo: input group does not exist" >&2
-  exit 1
-fi
-
-if ! id -nG "$USER" | tr ' ' '\n' | grep -qx input; then
-  echo "Adding $USER to the input group. You may need to log out and back in before this applies."
-  pkexec usermod -aG input "$USER"
-fi
-
-if omarchy-cmd-missing ydotool || omarchy-pkg-missing ydotool; then
-  omarchy-pkg-add ydotool
-fi
-
-pkexec /bin/bash -c '
-set -euo pipefail
-
-cat >"'"$RULE_FILE"'" <<'"'"'EOF'"'"'
-KERNEL=="uinput", GROUP="input", MODE="0660", OPTIONS+="static_node=uinput"
-EOF
-
-modprobe uinput
-udevadm control --reload-rules
-udevadm trigger /dev/uinput 2>/dev/null || true
-
-if [[ -e /dev/uinput ]]; then
-  chgrp input /dev/uinput
-  chmod 0660 /dev/uinput
-fi
-'
-
-systemctl --user reset-failed ydotool.service >/dev/null 2>&1 || true
-systemctl --user start ydotool.service
-
-if ! systemctl --user is-active --quiet ydotool.service; then
-  echo "omarchy-dev-install-ydoo: ydotool.service did not start" >&2
-  systemctl --user status ydotool.service --no-pager >&2 || true
-  exit 1
-fi
-
-echo "ydotool is ready."
@@ -1,20 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Open the omarchy-shell dev gallery (qs.Ui kit preview)
-# omarchy:args=[section]
-# omarchy:examples=omarchy dev ui-preview | omarchy dev ui-preview button | omarchy dev ui-preview button-group | omarchy dev ui-preview slider
-#
-# Pass a section name to jump straight to that component instead of
-# scrolling from the top. Section names match the cursor section ids in
-# shell/plugins/dev-gallery/GalleryPanel.qml — `button`, `button-group`,
-# `cursor-surface`, `slider`, `toggle`, `dropdown`, etc. Unknown names
-# are ignored and the gallery opens at its normal default position.
-
-if (( $# > 0 )) && [[ -n $1 ]]; then
-  section="$1"
-  payload=$(printf '{"section":"%s"}' "${section//\"/}")
-else
-  payload='{}'
-fi
-
-omarchy-shell shell summon omarchy.dev-gallery "$payload"
@@ -1,133 +0,0 @@
-#!/bin/bash
-
-# omarchy:summary=Show or configure the system DNS provider
-# omarchy:args=[Cloudflare|Google|DHCP|Custom]
-# omarchy:examples=omarchy dns | omarchy dns Cloudflare | omarchy dns Custom
-
-set -euo pipefail
-
-current_dns_provider() {
-  local dns=""
-  local compact=""
-
-  dns=$(awk -F= '
-    /^[[:space:]]*#/ { next }
-    /^[[:space:]]*DNS[[:space:]]*=/ {
-      value=$0
-      sub(/^[^=]*=/, "", value)
-      print value
-      exit
-    }
-  ' /etc/systemd/resolved.conf 2>/dev/null || true)
-
-  compact=$(printf '%s' "$dns" | tr -d '[:space:]')
-
-  if [[ -z $compact ]]; then
-    echo "DHCP"
-  elif [[ $dns == *"cloudflare-dns.com"* || $dns == *"1.1.1.1"* || $dns == *"2606:4700:4700::1111"* ]]; then
-    echo "Cloudflare"
-  elif [[ $dns == *"dns.google"* || $dns == *"8.8.8.8"* || $dns == *"2001:4860:4860::8888"* ]]; then
-    echo "Google"
-  else
-    echo "Custom"
-  fi
-}
-
-require_root() {
-  if (( EUID != 0 )); then
-    exec pkexec omarchy-dns "$@"
-  fi
-}
-
-lock_dns_to_resolved() {
-  local file=""
-
-  for file in /etc/systemd/network/*.network; do
-    [[ -f $file ]] || continue
-    if ! grep -q "^\[DHCPv4\]" "$file"; then continue; fi
-
-    if ! sed -n '/^\[DHCPv4\]/,/^\[/p' "$file" | grep -q "^UseDNS="; then
-      sed -i '/^\[DHCPv4\]/a UseDNS=no' "$file"
-    fi
-
-    if grep -q "^\[IPv6AcceptRA\]" "$file" && ! sed -n '/^\[IPv6AcceptRA\]/,/^\[/p' "$file" | grep -q "^UseDNS="; then
-      sed -i '/^\[IPv6AcceptRA\]/a UseDNS=no' "$file"
-    fi
-  done
-}
-
-unlock_dns_to_dhcp() {
-  local file=""
-
-  for file in /etc/systemd/network/*.network; do
-    [[ -f $file ]] || continue
-    sed -i '/^\[DHCPv4\]/{n;/^UseDNS=no$/d}' "$file"
-    sed -i '/^\[IPv6AcceptRA\]/{n;/^UseDNS=no$/d}' "$file"
-  done
-}
-
-if (( $# == 0 )); then
-  current_dns_provider
-  exit 0
-fi
-
-provider="$1"
-
-case "$provider" in
-Cloudflare)
-  require_root "$provider"
-  tee /etc/systemd/resolved.conf >/dev/null <<'EOF'
-[Resolve]
-DNS=1.1.1.1#cloudflare-dns.com 1.0.0.1#cloudflare-dns.com 2606:4700:4700::1111#cloudflare-dns.com 2606:4700:4700::1001#cloudflare-dns.com
-FallbackDNS=9.9.9.9#dns.quad9.net 149.112.112.112#dns.quad9.net 2620:fe::fe#dns.quad9.net 2620:fe::9#dns.quad9.net
-DNSOverTLS=opportunistic
-EOF
-  lock_dns_to_resolved
-  ;;
-
-Google)
-  require_root "$provider"
-  tee /etc/systemd/resolved.conf >/dev/null <<'EOF'
-[Resolve]
-DNS=8.8.8.8#dns.google 8.8.4.4#dns.google 2001:4860:4860::8888#dns.google 2001:4860:4860::8844#dns.google
-FallbackDNS=9.9.9.9#dns.quad9.net 149.112.112.112#dns.quad9.net 2620:fe::fe#dns.quad9.net 2620:fe::9#dns.quad9.net
-DNSOverTLS=opportunistic
-EOF
-  lock_dns_to_resolved
-  ;;
-
-DHCP)
-  require_root "$provider"
-  tee /etc/systemd/resolved.conf >/dev/null <<'EOF'
-[Resolve]
-DNSOverTLS=no
-EOF
-  unlock_dns_to_dhcp
-  ;;
-
-Custom)
-  require_root "$provider"
-  echo "Enter your DNS servers (space-separated, e.g. '192.168.1.1 1.1.1.1'):"
-  if ! read -r dns_servers; then
-    dns_servers=""
-  fi
-
-  if [[ -z $dns_servers ]]; then
-    echo "Error: No DNS servers provided." >&2
-    exit 1
-  fi
-
-  tee /etc/systemd/resolved.conf >/dev/null <<EOF
-[Resolve]
-DNS=$dns_servers
-FallbackDNS=9.9.9.9#dns.quad9.net 149.112.112.112#dns.quad9.net 2620:fe::fe#dns.quad9.net 2620:fe::9#dns.quad9.net
-EOF
-  lock_dns_to_resolved
-  ;;
-*)
-  echo "Usage: omarchy-dns [Cloudflare|Google|DHCP|Custom]" >&2
-  exit 1
-  ;;
-esac
-
-systemctl restart systemd-networkd systemd-resolved
@@ -1,7 +1,6 @@
 #!/bin/bash

-# omarchy:summary=Print drive information such as size, model, and mount details
-# omarchy:args=<drive>
+# Returns drive information about a given volumne, like /dev/nvme0, which is used by omarchy-drive-select.

 if (($# == 0)); then
  echo "Usage: omarchy-drive-info [/dev/drive]"
@@ -1,6 +1,6 @@
 #!/bin/bash

-# omarchy:summary=Select a drive from a list with info that includes space and brand. Used by omarchy-drive-password.
+# Select a drive from a list with info that includes space and brand. Used by omarchy-drive-set-password.

 if (($# == 0)); then
  drives=$(lsblk -dpno NAME | grep -E '/dev/(sd|hd|vd|nvme|mmcblk|xv)')
@@ -1,12 +1,11 @@
 #!/bin/bash

-# omarchy:summary=Set a new encryption password for a drive selected.
-# omarchy:requires-sudo=true
+# Set a new encryption password for a drive selected.

 encrypted_drives=$(blkid -t TYPE=crypto_LUKS -o device)

 if [[ -n $encrypted_drives ]]; then
-  if (( $(wc -l <<<"$encrypted_drives") == 1 )); then
+  if (( $(wc -l <<<encrypted_drives) == 1 )); then
    drive_to_change="$encrypted_drives"
  else
    drive_to_change="$(omarchy-drive-select "$encrypted_drives")"
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
David Heinemeier Hansson	2924278be5	Remove the migration too	2026-04-22 07:52:25 +02:00
David Heinemeier HanssonandGitHub	ca8e3c24de	Revert "Add battery identifier to Waybar config"	2026-04-22 07:51:12 +02:00