Fork the desktop off Omarchy as a self-contained system

2026-09-19 23:50:39 -04:00
parent 16a56f49a1
commit 9501f2bb4d
559 changed files with 43273 additions and 0 deletions
@@ -0,0 +1,71 @@
+# Menu tree
+
+`menu/menu.jsonc` is the single source for both menus: the apps menu on
+`Super + Space` and the root menu on `Super + Alt + Space`. There is no default
+tree merged underneath it and no user extension file layered on top, so a row
+sits where the file puts it. That is why the `before:` hint machinery the old
+menu fork carried is gone.
+
+## Trimmed from upstream
+
+Upstream ships 338 rows. This tree has 178. What came out:
+
+| Section | Dropped | Why |
+| --- | --- | --- |
+| `install.*` | 84 of 90 | the software catalogue: browsers, gaming, dev languages, AI tools, services. Kept: Package, AUR, TUI, and the Style subtree (theme, background, font) |
+| `remove.*` | 56 of 59 | same catalogue in reverse. Kept: Package, TUI, Theme |
+| `setup.default.agent.*` | 14 | AI agent defaults |
+| `update.channel.*` | 5 | release channels for a package that will not exist |
+| `learn.*` | 4 | Omarchy's manual and Discord, plus tmux and herdr keybindings |
+| `trigger.transcode` | 1 | transcode dropped |
+| `style.unlock` | 1 | plymouth theme switcher; `blob-boot-splash` covers splash images |
+| `update.config.tmux` | 1 | tmux dropped |
+| `setup.reset` | 1 | factory reset restores Omarchy defaults, which is wrong here |
+
+Docs rows now open in the browser (`blob-launch-browser`) rather than as web apps,
+which also keeps them working whichever way the web app question lands.
+
+## Commands the menu still needs
+
+The tree references 95 commands. 72 are not in `bin/` yet - this is the
+Phase 6 vendor list, grouped by area:
+
+- **audio**: `blob-audio-restart`
+- **bar**: `blob-bar`
+- **bluetooth**: `blob-bluetooth-restart`
+- **branding**: `blob-branding-about`, `blob-branding-screensaver`
+- **capture**: `blob-capture-qr`, `blob-capture-record`, `blob-capture-record-webcam`, `blob-capture-screenshot`, `blob-capture-text`
+- **drive**: `blob-drive-password`
+- **hibernation**: `blob-hibernation-available`
+- **hw**: `blob-hw-dell-xps-haptic-touchpad`, `blob-hw-fingerprint`, `blob-hw-hybrid-gpu`, `blob-hw-laptop`, `blob-hw-touchpad`, `blob-hw-touchscreen`, `blob-hw-webcam`
+- **hypr**: `blob-hypr-window-gaps-toggle`, `blob-hypr-window-single-square-aspect-toggle`, `blob-hypr-workspace-layout-toggle`
+- **install**: `blob-install-font`
+- **launch**: `blob-launch-about`, `blob-launch-config-editor`, `blob-launch-screensaver`
+- **menu**: `blob-menu-emoji`, `blob-menu-keybindings`, `blob-menu-plugin`, `blob-menu-share`, `blob-menu-timezone`
+- **network**: `blob-network-dns`, `blob-network-restart`, `blob-network-status`
+- **pkg**: `blob-pkg-aur-install`, `blob-pkg-install`, `blob-pkg-remove`
+- **plugin**: `blob-plugin-add`
+- **refresh**: `blob-refresh-hyprland`, `blob-refresh-hyprsunset`, `blob-refresh-plymouth`, `blob-refresh-shell`
+- **reminder**: `blob-reminder`
+- **restart**: `blob-restart-hyprsunset`, `blob-restart-trackpad`, `blob-restart-xcompose`
+- **setup**: `blob-setup-direct-boot`, `blob-setup-security-fido2`, `blob-setup-security-fingerprint`, `blob-setup-security-sshd`, `blob-setup-security-sudoless-docker`
+- **sudo**: `blob-sudo-docker`, `blob-sudo-passwordless`
+- **system**: `blob-system-lock`, `blob-system-logout`, `blob-system-reboot`, `blob-system-shutdown`
+- **theme**: `blob-theme-update`
+- **toggle**: `blob-toggle-bar`, `blob-toggle-crash-capture`, `blob-toggle-enabled`, `blob-toggle-glass`, `blob-toggle-hybrid-gpu`, `blob-toggle-idle`, `blob-toggle-nightlight`, `blob-toggle-screensaver`, `blob-toggle-silencing`, `blob-toggle-touchpad`, `blob-toggle-touchscreen`
+- **update**: `blob-update`, `blob-update-firmware`, `blob-update-time`
+
+Every one of these is reachable from a menu row, so a missing command shows up
+as a row that does nothing rather than a broken menu.
+
+## Reversed from the plan
+
+`02-keep-drop.md` put `omarchy-setup-*` in the drop list as one-time setup to run
+by hand. The menu disagrees: Setup > Security has rows for fingerprint, fido2,
+sshd and sudoless docker, and Setup > Direct Boot has one too. Those scripts are
+small, self-contained and genuinely useful, so they are vendored and the rows
+stay.
+
+`blob-capture-record-webcam` also stays a separate command rather than folding
+into `blob-capture-record --webcam` as planned, because the menu row calls it
+directly and upstream ships it as its own script.