From 1ae83f16064d68d7db682a620efa53ed4e37af93 Mon Sep 17 00:00:00 2001
From: David Heinemeier Hansson <david@hey.com>
Date: Thu, 13 Aug 2026 22:44:28 +0200
Subject: [PATCH] Add a switchers chapter and fix drift found on a second
 manual pass

Add "Coming From Mac or Windows" as chapter 3: a translation layer for
Cmd/Win instincts rather than a feature tour.

Fill the remaining coverage gaps: fcitx5 input methods, laptop speaker
tuning, touchpad haptics, crash capture in the toggle table, the
installable font list, and the ChatGPT Desktop and Grok Bot entries.

Correct claims that drifted from the source: the network and bluetooth
bar icons no longer launch nmtui/bluetoothctl, monitor scaling steps
rather than cycles, and the display widget's scroll steps brightness.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 manual/02-getting-started.md                  |  4 +-
 manual/03-coming-from-mac-or-windows.md       | 57 +++++++++++++++++++
 manual/{03-navigation.md => 04-navigation.md} |  0
 .../{04-the-top-bar.md => 05-the-top-bar.md}  | 16 +++---
 manual/{05-themes.md => 06-themes.md}         |  2 +-
 manual/{06-hotkeys.md => 07-hotkeys.md}       |  8 +--
 ...ory.md => 08-unified-clipboard-history.md} |  0
 manual/{08-reminders.md => 09-reminders.md}   |  0
 manual/{09-notices.md => 10-notices.md}       |  0
 ...ion.md => 11-text-extraction-dictation.md} |  0
 ...cording.md => 12-screenshots-recording.md} | 10 ++--
 ...aver.md => 13-toggles-idle-screensaver.md} | 11 ++--
 .../{13-omarchy-cli.md => 14-omarchy-cli.md}  |  0
 manual/{14-terminal.md => 15-terminal.md}     |  2 +-
 manual/{15-neovim.md => 16-neovim.md}         |  0
 manual/{16-ai.md => 17-ai.md}                 |  4 ++
 ...pment-tools.md => 18-development-tools.md} |  0
 .../{18-shell-tools.md => 19-shell-tools.md}  |  0
 ...ell-functions.md => 20-shell-functions.md} |  0
 manual/{20-tuis.md => 21-tuis.md}             |  2 +-
 manual/{21-guis.md => 22-guis.md}             |  4 +-
 manual/{22-browsers.md => 23-browsers.md}     |  6 +-
 ...ices.md => 24-commercial-apps-services.md} |  2 +-
 manual/{24-web-apps.md => 25-web-apps.md}     |  0
 manual/{25-gaming.md => 26-gaming.md}         |  0
 ...ing-out-pdfs.md => 27-filling-out-pdfs.md} |  0
 manual/{27-windows-vm.md => 28-windows-vm.md} |  0
 ...other-packages.md => 29-other-packages.md} |  0
 manual/{29-updates.md => 30-updates.md}       |  0
 manual/{30-dotfiles.md => 31-dotfiles.md}     |  0
 ...1-shell-plugins.md => 32-shell-plugins.md} |  2 +-
 manual/{32-monitors.md => 33-monitors.md}     |  2 +-
 ...ckpad.md => 34-keyboard-mouse-trackpad.md} |  6 ++
 manual/{34-networking.md => 35-networking.md} | 10 ++--
 ...{35-system-sleep.md => 36-system-sleep.md} |  0
 ...ation.md => 37-hardware-authentication.md} |  0
 manual/{37-fonts.md => 38-fonts.md}           |  2 +-
 .../{38-backgrounds.md => 39-backgrounds.md}  |  0
 manual/{39-prompt.md => 40-prompt.md}         |  0
 manual/{40-branding.md => 41-branding.md}     |  0
 ...1-common-tweaks.md => 42-common-tweaks.md} |  0
 ...{42-extra-themes.md => 43-extra-themes.md} |  0
 ...n-theme.md => 44-making-your-own-theme.md} |  2 +-
 .../{44-mac-support.md => 45-mac-support.md}  |  0
 ...oubleshooting.md => 46-troubleshooting.md} | 10 +++-
 manual/{46-faq.md => 47-faq.md}               |  4 +-
 ...em-snapshots.md => 48-system-snapshots.md} |  0
 manual/{48-security.md => 49-security.md}     |  0
 manual/{49-omarchy-on.md => 50-omarchy-on.md} |  0
 ...oot-install.md => 51-dual-boot-install.md} |  0
 ...-installs.md => 52-unattended-installs.md} |  0
 51 files changed, 119 insertions(+), 47 deletions(-)
 create mode 100644 manual/03-coming-from-mac-or-windows.md
 rename manual/{03-navigation.md => 04-navigation.md} (100%)
 rename manual/{04-the-top-bar.md => 05-the-top-bar.md} (94%)
 rename manual/{05-themes.md => 06-themes.md} (96%)
 rename manual/{06-hotkeys.md => 07-hotkeys.md} (98%)
 rename manual/{07-unified-clipboard-history.md => 08-unified-clipboard-history.md} (100%)
 rename manual/{08-reminders.md => 09-reminders.md} (100%)
 rename manual/{09-notices.md => 10-notices.md} (100%)
 rename manual/{10-text-extraction-dictation.md => 11-text-extraction-dictation.md} (100%)
 rename manual/{11-screenshots-recording.md => 12-screenshots-recording.md} (96%)
 rename manual/{12-toggles-idle-screensaver.md => 13-toggles-idle-screensaver.md} (95%)
 rename manual/{13-omarchy-cli.md => 14-omarchy-cli.md} (100%)
 rename manual/{14-terminal.md => 15-terminal.md} (98%)
 rename manual/{15-neovim.md => 16-neovim.md} (100%)
 rename manual/{16-ai.md => 17-ai.md} (97%)
 rename manual/{17-development-tools.md => 18-development-tools.md} (100%)
 rename manual/{18-shell-tools.md => 19-shell-tools.md} (100%)
 rename manual/{19-shell-functions.md => 20-shell-functions.md} (100%)
 rename manual/{20-tuis.md => 21-tuis.md} (98%)
 rename manual/{21-guis.md => 22-guis.md} (98%)
 rename manual/{22-browsers.md => 23-browsers.md} (94%)
 rename manual/{23-commercial-apps-services.md => 24-commercial-apps-services.md} (99%)
 rename manual/{24-web-apps.md => 25-web-apps.md} (100%)
 rename manual/{25-gaming.md => 26-gaming.md} (100%)
 rename manual/{26-filling-out-pdfs.md => 27-filling-out-pdfs.md} (100%)
 rename manual/{27-windows-vm.md => 28-windows-vm.md} (100%)
 rename manual/{28-other-packages.md => 29-other-packages.md} (100%)
 rename manual/{29-updates.md => 30-updates.md} (100%)
 rename manual/{30-dotfiles.md => 31-dotfiles.md} (100%)
 rename manual/{31-shell-plugins.md => 32-shell-plugins.md} (99%)
 rename manual/{32-monitors.md => 33-monitors.md} (94%)
 rename manual/{33-keyboard-mouse-trackpad.md => 34-keyboard-mouse-trackpad.md} (74%)
 rename manual/{34-networking.md => 35-networking.md} (88%)
 rename manual/{35-system-sleep.md => 36-system-sleep.md} (100%)
 rename manual/{36-hardware-authentication.md => 37-hardware-authentication.md} (100%)
 rename manual/{37-fonts.md => 38-fonts.md} (60%)
 rename manual/{38-backgrounds.md => 39-backgrounds.md} (100%)
 rename manual/{39-prompt.md => 40-prompt.md} (100%)
 rename manual/{40-branding.md => 41-branding.md} (100%)
 rename manual/{41-common-tweaks.md => 42-common-tweaks.md} (100%)
 rename manual/{42-extra-themes.md => 43-extra-themes.md} (100%)
 rename manual/{43-making-your-own-theme.md => 44-making-your-own-theme.md} (97%)
 rename manual/{44-mac-support.md => 45-mac-support.md} (100%)
 rename manual/{45-troubleshooting.md => 46-troubleshooting.md} (82%)
 rename manual/{46-faq.md => 47-faq.md} (97%)
 rename manual/{47-system-snapshots.md => 48-system-snapshots.md} (100%)
 rename manual/{48-security.md => 49-security.md} (100%)
 rename manual/{49-omarchy-on.md => 50-omarchy-on.md} (100%)
 rename manual/{50-dual-boot-install.md => 51-dual-boot-install.md} (100%)
 rename manual/{51-unattended-installs.md => 52-unattended-installs.md} (100%)

diff --git a/manual/02-getting-started.md b/manual/02-getting-started.md
index 009c0de4..57c1bda3 100644
--- a/manual/02-getting-started.md
+++ b/manual/02-getting-started.md
@@ -1,6 +1,6 @@
 # Getting Started
 
-Omarchy is installed using an ISO. You can choose between a full-disk install, which takes over the entire drive, or a free-space install, which puts Omarchy in the unallocated space on a drive — that's how you dual boot alongside Windows or another OS (see [dual-boot install](50-dual-boot-install.md) — note that you'll need to turn off BitLocker in Windows first). Either way, the installation uses full-disk encryption, and the full-disk option will wipe the selected drive, so be sure to take a backup before using an existing one!
+Omarchy is installed using an ISO. You can choose between a full-disk install, which takes over the entire drive, or a free-space install, which puts Omarchy in the unallocated space on a drive — that's how you dual boot alongside Windows or another OS (see [dual-boot install](51-dual-boot-install.md) — note that you'll need to turn off BitLocker in Windows first). Either way, the installation uses full-disk encryption, and the full-disk option will wipe the selected drive, so be sure to take a backup before using an existing one!
 
 [Download the Omarchy ISO](https://omarchy.org/) first, put it on a USB stick (use [balenaEtcher](https://etcher.balena.io/) on Mac/Windows or [caligula](https://github.com/ifd3f/caligula) on Linux), and boot off the stick.
 
@@ -32,7 +32,7 @@ It works by restoring the baseline snapshot the installer takes, so it's only av
 
 ### Unattended installs
 
-The ISO can also install completely on its own — no keyboard, no wizard — when it's handed its configuration on a second drive. That's the way to treat Omarchy as a base image for VMs and fleet machines. See [unattended installs](51-unattended-installs.md).
+The ISO can also install completely on its own — no keyboard, no wizard — when it's handed its configuration on a second drive. That's the way to treat Omarchy as a base image for VMs and fleet machines. See [unattended installs](52-unattended-installs.md).
 
 ### No-encryption installations
 
diff --git a/manual/03-coming-from-mac-or-windows.md b/manual/03-coming-from-mac-or-windows.md
new file mode 100644
index 00000000..b39aa222
--- /dev/null
+++ b/manual/03-coming-from-mac-or-windows.md
@@ -0,0 +1,57 @@
+# Coming From Mac or Windows
+
+If you've spent years on macOS or Windows, your fingers know a hundred things your brain has forgotten it ever learned. This chapter is the translation layer: where those instincts go in Omarchy. The features themselves are covered in depth elsewhere — this is just the map.
+
+### Super is the center of everything
+
+All the muscle memory you've built around Cmd or the Windows key transfers to one key: Super. That's the Windows key on a PC keyboard, and it's the anchor for nearly every hotkey in Omarchy.
+
+Your Spotlight or Start-menu reflex becomes `Super + Space`. That opens the Omarchy menu, which launches apps, changes settings, installs software, captures the screen — just about everything. Start typing to filter. There's also a dedicated apps-only menu on `Super + Alt + Space`. See [navigation](04-navigation.md).
+
+### There's no dock and no desktop icons
+
+Nothing to click to launch things, no icons to arrange on the desktop. Apps start from a hotkey (`Super + Return` for the terminal, `Super + Shift + Return` for the browser) or from the menu. The one persistent piece of UI is [the top bar](05-the-top-bar.md), which covers what the menu bar, system tray, and Notification Center did for you before — and nearly every widget on it does something on left, right, and middle click.
+
+### Windows place themselves
+
+The biggest mindset shift: you don't drag windows around or snap them to screen halves. Open a window and it takes the whole screen. Open a second and they split it. You never fish a window out from under another one, because windows don't overlap.
+
+When you genuinely need a floating window, `Super + T` toggles the active one out of the tiling (and back). But give the tiling a real chance first — it's the heart of the whole thing. [Navigation](04-navigation.md) walks you through it.
+
+Workspaces will feel familiar: they're macOS Spaces or Windows virtual desktops, except you'll actually use them, because `Super + 1/2/3/4` jumps straight to one and `Super + Shift + 1/2/3/4` sends the active window there.
+
+### Copy and paste just work
+
+On the Mac you had Cmd + C everywhere. On Windows you had Ctrl + C everywhere — except the terminal, where it kills your program. Omarchy gives you `Super + C`, `Super + X`, and `Super + V`, and they work everywhere, including the terminal. No separate reflex to learn for the shell.
+
+Windows folks: your Win + V clipboard history lives on `Super + Ctrl + V`, and it holds images as well as text. See [unified clipboard & history](08-unified-clipboard-history.md).
+
+### The translation table
+
+| You reach for | In Omarchy |
+| ------------- | ---------- |
+| Spotlight / Start menu | `Super + Space` — the Omarchy menu |
+| AirDrop | LocalSend, via `Super + Ctrl + S` — see [GUIs](22-guis.md) |
+| Cmd + Shift + 4 / Win + Shift + S | `Print Screen` — see [screenshots & recording](12-screenshots-recording.md) |
+| Notification Center | Notification history on `Super + Shift + Alt + ,` |
+| Time Machine (for the system) | Automatic [system snapshots](48-system-snapshots.md) on every update |
+| App Store / downloading an installer | _Install_ in the menu, or `omarchy pkg add` — see [other packages](29-other-packages.md) |
+| System Settings / Control Panel | _Setup_ in the menu, which edits plain config files — see [dotfiles](31-dotfiles.md) |
+
+### Some things really are different
+
+Settings live in text files you edit, not panels you click through. That sounds primitive until you realize it means every tweak can be seen, copied to your next machine, and put in version control. The _Setup_ menu drops you straight into the right file and restarts whatever needs restarting when you're done.
+
+Updates come through one command — _Update > Omarchy_ — that updates Omarchy itself and every package on the system, taking a snapshot first. No per-app updaters nagging you at random. See [updates](30-updates.md).
+
+Software comes from a package manager, not from downloaded installers. If you find yourself on a website hunting for a .exe-equivalent, stop and check _Install_ first.
+
+And when you close a window, the app actually quits. There's no macOS limbo where the program keeps running with no windows. `Super + W` means gone.
+
+### On Mac hardware
+
+Omarchy runs well on Intel Macs — see [Mac support](45-mac-support.md). And the keyboard is kind to you: Omarchy doesn't remap anything, and Linux treats the Command key as Super, so Super sits right where Cmd always was. Your thumb won't notice the move.
+
+### Give it two weeks
+
+The instincts transfer faster than you'd think. Skim the [hotkeys](07-hotkeys.md) chapter once, and whenever you blank on a binding, hit `Super + K` — it shows you all of them. That's the only hotkey you actually have to memorize.
diff --git a/manual/03-navigation.md b/manual/04-navigation.md
similarity index 100%
rename from manual/03-navigation.md
rename to manual/04-navigation.md
diff --git a/manual/04-the-top-bar.md b/manual/05-the-top-bar.md
similarity index 94%
rename from manual/04-the-top-bar.md
rename to manual/05-the-top-bar.md
index 9385dbc8..4642bfd7 100644
--- a/manual/04-the-top-bar.md
+++ b/manual/05-the-top-bar.md
@@ -8,7 +8,7 @@ It's also the one piece of the desktop that's always on screen, so it's worth kn
 
 The bar has three sections. On the left sits the Omarchy logo (the menu launcher) and the workspace indicators. In the center you get the status indicators, the clock, the keyboard layout, the weather, and an Omarchy update badge. On the right: the system tray, agents, bluetooth, network, audio, display, and power.
 
-A few of those only show up when they have something to say. The keyboard layout appears only if you've configured more than one layout. The update badge appears only when there's an Omarchy update waiting. And the agents icon appears the first time Omarchy finds AI coding usage on the machine (see [AI](16-ai.md)).
+A few of those only show up when they have something to say. The keyboard layout appears only if you've configured more than one layout. The update badge appears only when there's an Omarchy update waiting. And the agents icon appears the first time Omarchy finds AI coding usage on the machine (see [AI](17-ai.md)).
 
 ## Clicking around
 
@@ -22,9 +22,9 @@ Nearly every widget does something on left, right, and middle click, and several
 | Weather | Forecast popup | Full weather as a notification | Middle: refresh |
 | Audio | Audio panel | Mute | Middle: panel · scroll: volume |
 | Microphone | Mute the mic | — | Middle: audio panel · scroll: input volume |
-| Network | Network panel | `nmtui` in a terminal | — |
-| Bluetooth | Bluetooth panel | Toggle the radio | Middle: `bluetoothctl` TUI |
-| Display | Display panel | — | — |
+| Network | Network panel | — | — |
+| Bluetooth | Bluetooth panel | Toggle the radio | — |
+| Display | Display panel | — | Scroll: brightness |
 | Power | Power panel | Toggle the battery percentage | — |
 | Media | Play/pause | Cover-art popup | Middle: next · scroll: prev/next |
 | Agents | Agents panel | Launch your agent | Middle: next subscription |
@@ -53,7 +53,7 @@ The panels aren't read-outs. They're where you actually do the thing:
 - **Network** scans for Wi-Fi, shows signal strength, connects, and lets you pick a DNS provider.
 - **Bluetooth** lists your devices with connect/disconnect and battery levels.
 - **Power** shows battery stats, switches power profiles (it remembers a separate choice for battery and AC), and prints some system info.
-- **Display** carries a brightness slider, text size, monitor scaling presets, and — when you have more than one screen — per-monitor controls. See [monitors](32-monitors.md) for the deeper story.
+- **Display** carries a brightness slider, text size, monitor scaling presets, and — when you have more than one screen — per-monitor controls. See [monitors](33-monitors.md) for the deeper story.
 - **Clock** opens a month grid with ISO week numbers and month stepping.
 
 Every panel takes the keyboard as well as the mouse: arrows move, Return activates, Tab steps to the neighbouring panel, and Escape closes.
@@ -62,7 +62,7 @@ Every panel takes the keyboard as well as the mouse: arrows move, Return activat
 
 ### Panels without a bar icon
 
-A few panels live in the shell but never take up bar space. They're summoned from the [menu](03-navigation.md) instead:
+A few panels live in the shell but never take up bar space. They're summoned from the [menu](04-navigation.md) instead:
 
 - **Trigger → Speed Test → Network Speed Test** runs an internet speed test with download and upload dials.
 - **Trigger → Speed Test → Disk Speed Test** does the same for disk read and write.
@@ -80,7 +80,7 @@ Removing either service takes its widget back off the bar.
 
 ## Indicators
 
-The little cluster in the center is the indicators widget. These are status glyphs for modes you've turned on: do not disturb, night light, a queued [reminder](08-reminders.md), an active screen recording, stay awake, and [dictation](10-text-extraction-dictation.md). They light up when the mode is active and otherwise stay out of the way — hover the center of the bar to peek at the inactive ones. Clicking an indicator toggles that mode.
+The little cluster in the center is the indicators widget. These are status glyphs for modes you've turned on: do not disturb, night light, a queued [reminder](09-reminders.md), an active screen recording, stay awake, and [dictation](11-text-extraction-dictation.md). They light up when the mode is active and otherwise stay out of the way — hover the center of the bar to peek at the inactive ones. Clicking an indicator toggles that mode.
 
 If you'd rather they were always visible, set `alwaysShow` to `true` on the widget. And if you only care about some of them, list the ones you want in `items`: `["Dnd", "Reminder", "NightLight"]`. You can have more than one indicators widget, so different sections can show different subsets.
 
@@ -90,7 +90,7 @@ The bar configures itself. You don't have to open a config file to move things.
 
 Grab an empty patch of the bar around the center and drag it toward another screen edge, and the bar moves there — left, right, top, or bottom all work, and every widget adapts (vertical bars fall back to compact icon-only forms). A click-and-hold starts the same drag. Double-left-click that same empty space to toggle transparency. And drag any widget to reorder it or throw it into another section.
 
-The same things have commands, which is what you want for a [dotfiles](30-dotfiles.md) setup:
+The same things have commands, which is what you want for a [dotfiles](31-dotfiles.md) setup:
 
 ```bash
 omarchy bar position bottom
diff --git a/manual/05-themes.md b/manual/06-themes.md
similarity index 96%
rename from manual/05-themes.md
rename to manual/06-themes.md
index f56de999..afe33b20 100644
--- a/manual/05-themes.md
+++ b/manual/06-themes.md
@@ -6,7 +6,7 @@ Each theme styles the desktop, terminal, neovim, activity screen (btop), Chromiu
 
 Themes have a set of background images that you can pick between using `Super + Ctrl + Space`.
 
-You can find even more themes on [the extra themes page](42-extra-themes.md) or even [make your own theme](43-making-your-own-theme.md).
+You can find even more themes on [the extra themes page](43-extra-themes.md) or even [make your own theme](44-making-your-own-theme.md).
 
  ![tokyo-night.png](https://learn.omacom.io/u/tokyo-night-yN9jzd.png)
 _Tokyo Night_
diff --git a/manual/06-hotkeys.md b/manual/07-hotkeys.md
similarity index 98%
rename from manual/06-hotkeys.md
rename to manual/07-hotkeys.md
index 845a1382..88a46bf4 100644
--- a/manual/06-hotkeys.md
+++ b/manual/07-hotkeys.md
@@ -51,8 +51,8 @@ You can see all the main keyboard bindings with `Super + K` (Tmux bindings with
 | `Super + Alt + S` | Move window to scratchpad workspace |
 | `Super + Ctrl + Z` | Zoom in on screen (repeat for more zoom) |
 | `Super + Ctrl + Alt + Z` | Zoom fully out from screen |
-| `Super + /` | Cycle forward through monitor scaling options |
-| `Super + Alt + /` | Cycle backward through monitor scaling options |
+| `Super + /` | Step forward through monitor scaling options |
+| `Super + Alt + /` | Step backward through monitor scaling options |
 | `Alt + Tab` | Cycle forward through windows on the active workspace |
 | `Alt + Shift + Tab` | Cycle backward through windows on the active workspace |
 | `Ctrl + Alt + Tab`| Cycle focus forward through monitors |
@@ -153,7 +153,7 @@ Usually on Linux, you need `Ctrl + Shift + C/V` to copy'n'paste in the terminal
 | `Super + Ctrl + X` | Start/stop dictation (requires _Install > AI > Dictation_) |
 | `F9` | Push-to-talk dictation (requires _Install > AI > Dictation_) |
 
-With screenrecordings, the hotkey first asks which audio you want, then starts recording. Hit it again to stop. See [screenshots and recording](11-screenshots-recording.md) for the details.
+With screenrecordings, the hotkey first asks which audio you want, then starts recording. Hit it again to stop. See [screenshots and recording](12-screenshots-recording.md) for the details.
 
 All capture options are also accessible under _Trigger > Capture_ in the Omarchy menu (`Super + Space`).
 
@@ -289,7 +289,7 @@ Ghostty terminal is installed using _Install > Terminal_ via the Omarchy menu.
 | `Super + Ctrl + Shift + Arrows` | Resize split by 10 lines |
 | `Super + Ctrl + Shift + Alt + Arrows` | Resize split by 100 lines |
 | `Ctrl + Shift + T` | New tab  |
-| `Ctrl + Shift + Arrows` | Move between tabs tab |
+| `Ctrl + Shift + Arrows` | Move between tabs |
 | `Alt + Numbers` | Go to specific tab |
 | `Shift + Pg Up/Down` | Scroll the history |
 | `Ctrl + Left mouse` | Open link in browser |
diff --git a/manual/07-unified-clipboard-history.md b/manual/08-unified-clipboard-history.md
similarity index 100%
rename from manual/07-unified-clipboard-history.md
rename to manual/08-unified-clipboard-history.md
diff --git a/manual/08-reminders.md b/manual/09-reminders.md
similarity index 100%
rename from manual/08-reminders.md
rename to manual/09-reminders.md
diff --git a/manual/09-notices.md b/manual/10-notices.md
similarity index 100%
rename from manual/09-notices.md
rename to manual/10-notices.md
diff --git a/manual/10-text-extraction-dictation.md b/manual/11-text-extraction-dictation.md
similarity index 100%
rename from manual/10-text-extraction-dictation.md
rename to manual/11-text-extraction-dictation.md
diff --git a/manual/11-screenshots-recording.md b/manual/12-screenshots-recording.md
similarity index 96%
rename from manual/11-screenshots-recording.md
rename to manual/12-screenshots-recording.md
index 58f12485..9f963ff8 100644
--- a/manual/11-screenshots-recording.md
+++ b/manual/12-screenshots-recording.md
@@ -17,7 +17,7 @@ Hit `Print Screen` and the screen freezes so nothing shifts under you while you
 
 The result goes two places at once: a PNG in your pictures directory, and the clipboard, so you can paste it straight into a chat window with `Super + V`. A notification pops up with a thumbnail. Click it (or hit `Super + Alt + ,` to invoke the last notification) and the shot opens in Tensaku, the annotation editor, where you can draw arrows and boxes on it before you send it.
 
-Files land in `~/Pictures` by default, named `screenshot-2026-08-13_14-22-05.png`. If you'd rather keep them in their own folder, set `OMARCHY_SCREENSHOT_DIR` — see [the FAQ](46-faq.md) for where to put session environment variables. Omarchy creates the directory for you if it isn't there. You can swap the editor too with `OMARCHY_SCREENSHOT_EDITOR`.
+Files land in `~/Pictures` by default, named `screenshot-2026-08-13_14-22-05.png`. If you'd rather keep them in their own folder, set `OMARCHY_SCREENSHOT_DIR` — see [the FAQ](47-faq.md) for where to put session environment variables. Omarchy creates the directory for you if it isn't there. You can swap the editor too with `OMARCHY_SCREENSHOT_EDITOR`.
 
 From the terminal, `omarchy screenshot` takes the same shot, and you can be explicit about it: `omarchy capture screenshot region` for freeform only, `windows` to snap to window and monitor rectangles, or `fullscreen` to skip the picker entirely and grab the focused monitor. A second argument of `copy` puts the shot only on the clipboard, and `save` only on disk.
 
@@ -59,9 +59,9 @@ You can also call it directly with `omarchy-capture-webcam-resize small`, or `re
 
 ## Text, QR codes, and colours
 
-`Super + Ctrl + Print Screen` selects a region and OCRs it to the clipboard. That's covered properly in [Text Extraction & Dictation](10-text-extraction-dictation.md).
+`Super + Ctrl + Print Screen` selects a region and OCRs it to the clipboard. That's covered properly in [Text Extraction & Dictation](11-text-extraction-dictation.md).
 
-_Trigger > Capture > QR Code_ does the same trick for QR codes. Select the region with the code in it, and the decoded value goes to the clipboard. It only looks for QR codes — dense screen content has a habit of false-positiving as a barcode otherwise. Worth knowing: the decoded value goes to the clipboard and nowhere else. It isn't printed, it isn't in the notification, and it's marked sensitive so it doesn't stick around in [clipboard history](07-unified-clipboard-history.md). QR codes routinely carry secrets — the `otpauth://` URI behind a 2FA setup code, for one — and you don't want that in a log. Pasting still works fine.
+_Trigger > Capture > QR Code_ does the same trick for QR codes. Select the region with the code in it, and the decoded value goes to the clipboard. It only looks for QR codes — dense screen content has a habit of false-positiving as a barcode otherwise. Worth knowing: the decoded value goes to the clipboard and nowhere else. It isn't printed, it isn't in the notification, and it's marked sensitive so it doesn't stick around in [clipboard history](08-unified-clipboard-history.md). QR codes routinely carry secrets — the `otpauth://` URI behind a 2FA setup code, for one — and you don't want that in a log. Pasting still works fine.
 
 `Super + Print Screen` (or _Trigger > Capture > Color_) turns the cursor into an eyedropper. Click anything on screen and the colour lands on the clipboard. Press the hotkey again to back out without picking.
 
@@ -71,8 +71,8 @@ A 4K screen recording or a raw HEIC off your phone is often too big to just send
 
 Pictures go to jpg or png at high, medium, or low, which cap the width at 3160, 2160, and 1080 pixels. Videos go to mp4 or an animated gif at 4k, 1080p, or 720p. The converted file is written next to the original with the resolution in the name — `demo-1080p.mp4` — and the path is copied to the clipboard as a file URI, so you can paste it directly into an app that takes file drops.
 
-It works from the terminal too, if you already know what you want: `omarchy transcode ~/Videos/demo.mov mp4 1080p`. There's also `omarchy transcode ascii`, which turns an image into ASCII art — that one's mostly for [branding](40-branding.md).
+It works from the terminal too, if you already know what you want: `omarchy transcode ~/Videos/demo.mov mp4 1080p`. There's also `omarchy transcode ascii`, which turns an image into ASCII art — that one's mostly for [branding](41-branding.md).
 
 ## Sending it somewhere
 
-Once you've got the file, `Super + Ctrl + S` opens the Share menu and sends it to another device on your network via LocalSend. See [GUIs](21-guis.md) for that.
+Once you've got the file, `Super + Ctrl + S` opens the Share menu and sends it to another device on your network via LocalSend. See [GUIs](22-guis.md) for that.
diff --git a/manual/12-toggles-idle-screensaver.md b/manual/13-toggles-idle-screensaver.md
similarity index 95%
rename from manual/12-toggles-idle-screensaver.md
rename to manual/13-toggles-idle-screensaver.md
index 862e54d2..6c01398c 100644
--- a/manual/12-toggles-idle-screensaver.md
+++ b/manual/13-toggles-idle-screensaver.md
@@ -13,6 +13,7 @@ From the terminal, the same switches are `omarchy toggle <thing>`. Run `omarchy
 | Night light | `Super + Ctrl + N` | `omarchy toggle nightlight` |
 | Silence notifications | `Super + Ctrl + ,` | `omarchy toggle notification silencing` |
 | Stay awake (no idle lock) | `Super + Ctrl + I` | `omarchy toggle idle` |
+| Crash capture | — | `omarchy toggle crash-capture` |
 | Screensaver | — | `omarchy toggle screensaver` |
 | Menu bar | `Super + Shift + Space` | `omarchy toggle bar` |
 | Touchpad | `XF86TouchpadToggle` | `omarchy toggle touchpad` |
@@ -36,7 +37,7 @@ The flags are named for the off state — `screensaver-off`, `suspend-off`, `bar
 
 When a mode is on, you get a small glyph in the middle of the top bar next to the clock. That's the indicators widget, and it carries dictation, screen recording, pending reminders, night light, do not disturb, and stay awake.
 
-Inactive indicators are hidden. Hover the area around them and they fade in dimmed, so you can click one to turn it on without knowing its hotkey. Clicking an active one turns it back off. If you'd rather see all of them all the time, set `alwaysShow` to `true` on the `omarchy.indicators` entry in `~/.config/omarchy/shell.json` — see [the top bar](04-the-top-bar.md) for how bar widgets are configured.
+Inactive indicators are hidden. Hover the area around them and they fade in dimmed, so you can click one to turn it on without knowing its hotkey. Clicking an active one turns it back off. If you'd rather see all of them all the time, set `alwaysShow` to `true` on the `omarchy.indicators` entry in `~/.config/omarchy/shell.json` — see [the top bar](05-the-top-bar.md) for how bar widgets are configured.
 
 ### Night light
 
@@ -57,7 +58,7 @@ Then start hyprsunset at login by adding `o.launch_on_start("hyprsunset")` to `~
 
 `Super + Ctrl + ,` silences notifications. No toasts pop up while it's on, and the crossed-out bell indicator sits in the bar to remind you why the desktop has gone quiet.
 
-Nothing is lost, though. A silenced notification is written straight into your notification history, which is exactly the record you want when you come back and wonder what you missed. Open it with `Super + Shift + Alt + ,`. See [notices](09-notices.md) for the rest of the notification story.
+Nothing is lost, though. A silenced notification is written straight into your notification history, which is exactly the record you want when you come back and wonder what you missed. Open it with `Super + Shift + Alt + ,`. See [notices](10-notices.md) for the rest of the notification story.
 
 Two kinds of message still get through: Omarchy's own confirmation toasts for something you just did ("Theme changed", "Screenshot saved"), and critical alerts sent from the command line. Chat apps that mark everything critical to force their way in front of you don't qualify.
 
@@ -81,7 +82,7 @@ If you dismiss the screensaver before the lock deadline, that counts as activity
 
 To stop locking on idle entirely, `Super + Ctrl + I` — or `omarchy toggle idle` — flips stay awake on, and the coffee cup indicator appears in the bar. That's the one to hit before a long presentation or a build you want to watch. Hit it again to go back to normal. `omarchy toggle idle status` prints the current state as JSON if you need it from a script.
 
-This is about locking and the screensaver, not power. Suspend and hibernation have their own setup in [system sleep](35-system-sleep.md).
+This is about locking and the screensaver, not power. Suspend and hibernation have their own setup in [system sleep](36-system-sleep.md).
 
 ### The screensaver
 
@@ -91,10 +92,10 @@ You can start it on demand from _System > Screensaver_ (`Super + Esc`), which fo
 
 `omarchy toggle screensaver` is what turns the idle one off, if you'd rather go straight from working to locked. It needs a terminal it knows how to configure — Alacritty, Foot, Ghostty, or Kitty — and will tell you so if your default terminal is something else.
 
-The logo it draws is yours to change, under _Style > Screensaver_. Upload a png or svg and Omarchy converts it to ASCII. See [branding](40-branding.md).
+The logo it draws is yours to change, under _Style > Screensaver_. Upload a png or svg and Omarchy converts it to ASCII. See [branding](41-branding.md).
 
 ### The lock screen
 
 `Super + Ctrl + L` locks the machine. That runs the lock screen from the Omarchy shell, blanks the display, resets your keyboard layout to the first one so you're not typing your password in the wrong alphabet, and — if you have it running — locks 1Password on the way out.
 
-The lock screen takes a password, and it'll take a fingerprint too once you've set one up. That, and the other ways to authenticate, are covered in [hardware authentication](36-hardware-authentication.md).
+The lock screen takes a password, and it'll take a fingerprint too once you've set one up. That, and the other ways to authenticate, are covered in [hardware authentication](37-hardware-authentication.md).
diff --git a/manual/13-omarchy-cli.md b/manual/14-omarchy-cli.md
similarity index 100%
rename from manual/13-omarchy-cli.md
rename to manual/14-omarchy-cli.md
diff --git a/manual/14-terminal.md b/manual/15-terminal.md
similarity index 98%
rename from manual/14-terminal.md
rename to manual/15-terminal.md
index fc1c4839..07278099 100644
--- a/manual/14-terminal.md
+++ b/manual/15-terminal.md
@@ -12,7 +12,7 @@ Tmux provides a consistent, programmable interface for panes, windows (aka tabs)
 
 You start a new Tmux session in a fresh terminal using `Super + Alt + Return`, and because Tmux is a persistent process, you can resume your session even if you close that terminal. Just hit `Ctrl + Space` (called the prefix key) then `s` to see all your active sessions.
 
-Omarchy ships with an ergonomically-optimized Tmux configuration, which has a lot of keybindings to learn, so keep [the cheatsheet handy](06-hotkeys.md#tmux).
+Omarchy ships with an ergonomically-optimized Tmux configuration, which has a lot of keybindings to learn, so keep [the cheatsheet handy](07-hotkeys.md#tmux).
 
 ## Tmux layout functions
 
diff --git a/manual/15-neovim.md b/manual/16-neovim.md
similarity index 100%
rename from manual/15-neovim.md
rename to manual/16-neovim.md
diff --git a/manual/16-ai.md b/manual/17-ai.md
similarity index 97%
rename from manual/16-ai.md
rename to manual/17-ai.md
index 05cf66ba..8a265fbf 100644
--- a/manual/16-ai.md
+++ b/manual/17-ai.md
@@ -36,6 +36,10 @@ Omarchy watches systemd-coredump for process crashes. When something segfaults,
 
 The watching is on by default. Turn it off under _Trigger > Toggle > Crash Capture_ (or with `omarchy toggle crash-capture`) and the notifications stop; `omarchy agent crash <pid>` still works by hand.
 
+### Desktop apps
+
+The _Install > AI_ menu also carries a couple of graphical AI apps: the ChatGPT desktop app, and Grok Bot for chatting with xAI's models.
+
 ### Local LLMs
 
 Omarchy recommends two ways of running local LLM models: LM Studio and Ollama. LM Studio provides a GUI interface for finding open-weight models, installing them, and running them. It's a great way to get going easily. Ollama offers a CLI for doing so similarly. But if you're new to local models, I'd start with LM Studio. You can install either under _Install > AI_ in the Omarchy Menu.
diff --git a/manual/17-development-tools.md b/manual/18-development-tools.md
similarity index 100%
rename from manual/17-development-tools.md
rename to manual/18-development-tools.md
diff --git a/manual/18-shell-tools.md b/manual/19-shell-tools.md
similarity index 100%
rename from manual/18-shell-tools.md
rename to manual/19-shell-tools.md
diff --git a/manual/19-shell-functions.md b/manual/20-shell-functions.md
similarity index 100%
rename from manual/19-shell-functions.md
rename to manual/20-shell-functions.md
diff --git a/manual/20-tuis.md b/manual/21-tuis.md
similarity index 98%
rename from manual/20-tuis.md
rename to manual/21-tuis.md
index 4d4593ac..5e923324 100644
--- a/manual/20-tuis.md
+++ b/manual/21-tuis.md
@@ -44,7 +44,7 @@ When the drive fills up and you have no idea what's eating it, launch _Disk Usag
 
 ## What about Wi-Fi and Bluetooth?
 
-You won't find TUIs for Wi-Fi and Bluetooth — those jobs belong to the Omarchy shell. Click the Wi-Fi icon in the top bar (or hit `Super + Ctrl + W`) to see networks and connect, and click the Bluetooth icon (or hit `Super + Ctrl + B`) to pair and connect devices. See [networking](34-networking.md) for the full story.
+You won't find TUIs for Wi-Fi and Bluetooth — those jobs belong to the Omarchy shell. Click the Wi-Fi icon in the top bar (or hit `Super + Ctrl + W`) to see networks and connect, and click the Bluetooth icon (or hit `Super + Ctrl + B`) to pair and connect devices. See [networking](35-networking.md) for the full story.
 
 ## Adding your own
 
diff --git a/manual/21-guis.md b/manual/22-guis.md
similarity index 98%
rename from manual/21-guis.md
rename to manual/22-guis.md
index f5dfa8e8..8845bb4f 100644
--- a/manual/21-guis.md
+++ b/manual/22-guis.md
@@ -32,7 +32,7 @@ You start Pinta via the application launcher (`Super + Space`).
 
 ## Aether
 
-[Aether](https://github.com/bjarneo/aether) is a theming application that can extract colors from a background image and turn them into a complete, cohesive theme. It's the easiest way to [make your own theme](43-making-your-own-theme.md).
+[Aether](https://github.com/bjarneo/aether) is a theming application that can extract colors from a background image and turn them into a complete, cohesive theme. It's the easiest way to [make your own theme](44-making-your-own-theme.md).
 
 You start Aether via the application launcher (`Super + Space`).
 
@@ -51,7 +51,7 @@ The same thing works from the terminal with `omarchy share clipboard`, `omarchy
 
 You can also send straight from the file manager: right-click any selection in Nautilus and pick _Send via LocalSend_.
 
-Omarchy's firewall is closed by default except for LocalSend's port, so this works out of the box on a fresh install. See [security](48-security.md).
+Omarchy's firewall is closed by default except for LocalSend's port, so this works out of the box on a fresh install. See [security](49-security.md).
 
 ## LibreOffice
 
diff --git a/manual/22-browsers.md b/manual/23-browsers.md
similarity index 94%
rename from manual/22-browsers.md
rename to manual/23-browsers.md
index fdb37566..aced842d 100644
--- a/manual/22-browsers.md
+++ b/manual/23-browsers.md
@@ -1,6 +1,6 @@
 # Browsers
 
-Omarchy ships with [Chromium](https://www.chromium.org/) as the default browser. It's the plain open-source build, themed to match the rest of your system, and it's what `Super + Shift + Return` opens and what every [web app](24-web-apps.md) runs inside.
+Omarchy ships with [Chromium](https://www.chromium.org/) as the default browser. It's the plain open-source build, themed to match the rest of your system, and it's what `Super + Shift + Return` opens and what every [web app](25-web-apps.md) runs inside.
 
 If Chromium isn't your taste, you're not stuck with it. Under _Install > Browser_ in the Omarchy menu you'll find Chrome, Edge, Brave, Brave Origin, Firefox, and [Zen](https://zen-browser.app/). Pick one and Omarchy installs it, sets up its policy directory, and applies your current theme to it.
 
@@ -20,9 +20,9 @@ Run it with no argument and it tells you the current default. This sets the XDG
 
 The Chromium-family browsers (Chromium itself, Chrome, Edge, and Brave) come with two Omarchy extensions that reach out of the browser and into the rest of your system.
 
-**Copy URL** puts the current tab's address on your clipboard with `Alt + Shift + L`. That's faster than clicking into the address bar and copying, and because it goes through the system clipboard rather than the browser's, you get an Omarchy notification confirming it and the URL is immediately available in [clipboard history](07-unified-clipboard-history.md) and every other app. There's a toolbar button too, if you prefer clicking.
+**Copy URL** puts the current tab's address on your clipboard with `Alt + Shift + L`. That's faster than clicking into the address bar and copying, and because it goes through the system clipboard rather than the browser's, you get an Omarchy notification confirming it and the URL is immediately available in [clipboard history](08-unified-clipboard-history.md) and every other app. There's a toolbar button too, if you prefer clicking.
 
-**Download Video** grabs the video playing on the page you're looking at with `Alt + Shift + D`. It hands the URL to [yt-dlp](https://github.com/yt-dlp/yt-dlp), so it works on far more than YouTube, and the download lands in `~/Videos`. Progress shows up in the same on-screen display that volume and brightness use, updating in place rather than stacking up notifications. Set `OMARCHY_YTDLP_DIR` if you'd rather the files went somewhere else — see the [FAQ](46-faq.md) for where to put environment variables.
+**Download Video** grabs the video playing on the page you're looking at with `Alt + Shift + D`. It hands the URL to [yt-dlp](https://github.com/yt-dlp/yt-dlp), so it works on far more than YouTube, and the download lands in `~/Videos`. Progress shows up in the same on-screen display that volume and brightness use, updating in place rather than stacking up notifications. Set `OMARCHY_YTDLP_DIR` if you'd rather the files went somewhere else — see the [FAQ](47-faq.md) for where to put environment variables.
 
 Both extensions talk to Omarchy through a small native messaging host, which gets installed for you along with the browser. That's the piece that lets a web page's video end up in your home directory and a URL end up in your clipboard manager, which a normal extension can't do on its own.
 
diff --git a/manual/23-commercial-apps-services.md b/manual/24-commercial-apps-services.md
similarity index 99%
rename from manual/23-commercial-apps-services.md
rename to manual/24-commercial-apps-services.md
index 12d643b8..462c67ee 100644
--- a/manual/23-commercial-apps-services.md
+++ b/manual/24-commercial-apps-services.md
@@ -26,7 +26,7 @@ You start Spotify using `Super + Shift + M`. Like 1Password, the hotkey kicks of
 
 [Tailscale](https://tailscale.com/) is a mesh VPN that makes getting access to all your computers and servers over the internet securely super simple. To set it up, select _Install > Service > Tailscale_ from the Omarchy menu.
 
-It gets a panel in the bar, a web app for the admin console, and Taildrop for sending files between your machines — see [networking](34-networking.md).
+It gets a panel in the bar, a web app for the admin console, and Taildrop for sending files between your machines — see [networking](35-networking.md).
 
 ## ONCE
 
diff --git a/manual/24-web-apps.md b/manual/25-web-apps.md
similarity index 100%
rename from manual/24-web-apps.md
rename to manual/25-web-apps.md
diff --git a/manual/25-gaming.md b/manual/26-gaming.md
similarity index 100%
rename from manual/25-gaming.md
rename to manual/26-gaming.md
diff --git a/manual/26-filling-out-pdfs.md b/manual/27-filling-out-pdfs.md
similarity index 100%
rename from manual/26-filling-out-pdfs.md
rename to manual/27-filling-out-pdfs.md
diff --git a/manual/27-windows-vm.md b/manual/28-windows-vm.md
similarity index 100%
rename from manual/27-windows-vm.md
rename to manual/28-windows-vm.md
diff --git a/manual/28-other-packages.md b/manual/29-other-packages.md
similarity index 100%
rename from manual/28-other-packages.md
rename to manual/29-other-packages.md
diff --git a/manual/29-updates.md b/manual/30-updates.md
similarity index 100%
rename from manual/29-updates.md
rename to manual/30-updates.md
diff --git a/manual/30-dotfiles.md b/manual/31-dotfiles.md
similarity index 100%
rename from manual/30-dotfiles.md
rename to manual/31-dotfiles.md
diff --git a/manual/31-shell-plugins.md b/manual/32-shell-plugins.md
similarity index 99%
rename from manual/31-shell-plugins.md
rename to manual/32-shell-plugins.md
index c5c95085..d54df3fb 100644
--- a/manual/31-shell-plugins.md
+++ b/manual/32-shell-plugins.md
@@ -27,7 +27,7 @@ Or use the menu: _Setup > Plugins_ has Enable, Disable, Add, Clone, and Remove,
 
 Enabled state is stored in `~/.config/omarchy/shell.json`, and the rule differs slightly for the two kinds of plugin. A third-party plugin is enabled exactly when its id appears somewhere in that file — as a bar layout entry, as an entry in `plugins[]`, or as `bar.id`. First-party plugins that aren't bar widgets are the other way around: they're on by default and only turn off by being listed in `disabledPlugins[]`.
 
-A full bar plugin has no off state at all. There's always exactly one bar, so you replace it by enabling another one. Bar widget placement is covered in [the top bar](04-the-top-bar.md).
+A full bar plugin has no off state at all. There's always exactly one bar, so you replace it by enabling another one. Bar widget placement is covered in [the top bar](05-the-top-bar.md).
 
 ## Adding a plugin from git
 
diff --git a/manual/32-monitors.md b/manual/33-monitors.md
similarity index 94%
rename from manual/32-monitors.md
rename to manual/33-monitors.md
index 314bdc3d..e6a5e30e 100644
--- a/manual/32-monitors.md
+++ b/manual/33-monitors.md
@@ -18,7 +18,7 @@ local omarchy_monitor_scale = 1
 
 Changes to `GDK_SCALE` apply to applications started after the change (and GTK only honors whole numbers, so keep it at the nearest integer of your monitor scale). So make sure you quit the windows that you have that are oversized after the change (or close all windows with `Ctrl + Alt + Del`!).
 
-You can also quickly cycle through the major monitor scaling ratios (1x, 1.25x, 1.6x, 2x, 3x, 4x) using `Super + /` to go higher and `Super + Alt + /` to go lower. If you have the default configuration, these changes will also persist past reboot.
+You can also quickly step through the major monitor scaling ratios (1x, 1.25x, 1.6x, 2x, 3x, 4x) using `Super + /` to go higher and `Super + Alt + /` to go lower. If you have the default configuration, these changes will also persist past reboot.
 
 ### Making text bigger or smaller
 
diff --git a/manual/33-keyboard-mouse-trackpad.md b/manual/34-keyboard-mouse-trackpad.md
similarity index 74%
rename from manual/33-keyboard-mouse-trackpad.md
rename to manual/34-keyboard-mouse-trackpad.md
index 2d13a7c2..1d2dae83 100644
--- a/manual/33-keyboard-mouse-trackpad.md
+++ b/manual/34-keyboard-mouse-trackpad.md
@@ -45,6 +45,12 @@ You can also turn on [touchpad gestures](https://wiki.hypr.land/Configuring/Adva
 hl.gesture({ fingers = 3, direction = "horizontal", action = "workspace" })
 ```
 
+On Dell XPS laptops with a haptic touchpad, you can also set the click strength to low, mid, or high under _Trigger > Hardware > Touchpad Haptics_.
+
+### Typing in Chinese, Japanese, and other languages
+
+Omarchy runs the [fcitx5](https://fcitx-im.org/) input method framework as part of every session — it's what powers the CapsLock compose sequences. That means the plumbing for non-Latin input is already in place: install an input engine like `fcitx5-mozc` (Japanese) or `fcitx5-chinese-addons` (Chinese) with `omarchy pkg add`, plus `fcitx5-configtool` to add the engine to your input methods and set the key that switches between them.
+
 ### Use ALT as SUPER
 
 On some keyboards, it's not convenient to use the primary meta key (Windows/cmd key) as SUPER. You can change this to be ALT instead using this change:
diff --git a/manual/34-networking.md b/manual/35-networking.md
similarity index 88%
rename from manual/34-networking.md
rename to manual/35-networking.md
index 4d39f622..96755129 100644
--- a/manual/34-networking.md
+++ b/manual/35-networking.md
@@ -1,8 +1,8 @@
 # Networking
 
-Networking in Omarchy is handled by NetworkManager, and you drive it from the network icon in the [top bar](04-the-top-bar.md) or with `Super + Ctrl + W`.
+Networking in Omarchy is handled by NetworkManager, and you drive it from the network icon in the [top bar](05-the-top-bar.md) or with `Super + Ctrl + W`.
 
-That panel scans for Wi-Fi networks, shows signal strength, and connects. Ethernet needs nothing at all — plug it in and it works. If you'd rather stay in the terminal, `nmtui` is one right-click away on the same icon, and there's an `omarchy network` command group too.
+That panel scans for Wi-Fi networks, shows signal strength, and connects. Ethernet needs nothing at all — plug it in and it works. If you'd rather stay in the terminal, `nmtui` gives you the same controls, and there's an `omarchy network` command group too.
 
 ## Sharing your Wi-Fi
 
@@ -28,9 +28,9 @@ _Trigger > Speed Test > Network Speed Test_ measures your actual up and down spe
 
 ## The firewall
 
-The firewall is on by default and blocks all incoming traffic, with one exception: port 53317, so [LocalSend](21-guis.md) works out of the box.
+The firewall is on by default and blocks all incoming traffic, with one exception: port 53317, so [LocalSend](22-guis.md) works out of the box.
 
-SSH is off until you turn it on with _Setup > Security > SSHD_, which starts the daemon, opens port 22 rate-limited against brute force, and authorizes a key. Docker is locked down too, so containers can't accidentally expose themselves to the world. See [security](48-security.md) for the whole story.
+SSH is off until you turn it on with _Setup > Security > SSHD_, which starts the daemon, opens port 22 rate-limited against brute force, and authorizes a key. Docker is locked down too, so containers can't accidentally expose themselves to the world. See [security](49-security.md) for the whole story.
 
 ## Tailscale
 
@@ -42,4 +42,4 @@ Installing it also adds a web app for the Tailscale admin console.
 
 ## When it stops working
 
-Before rebooting, try restarting the offending piece on its own. _Update > Hardware_ has Wi-Fi, Bluetooth, Audio, and Trackpad, and reloading one of those clears up most "it worked five minutes ago" situations. See [troubleshooting](45-troubleshooting.md).
+Before rebooting, try restarting the offending piece on its own. _Update > Hardware_ has Wi-Fi, Bluetooth, Audio, and Trackpad, and reloading one of those clears up most "it worked five minutes ago" situations. See [troubleshooting](46-troubleshooting.md).
diff --git a/manual/35-system-sleep.md b/manual/36-system-sleep.md
similarity index 100%
rename from manual/35-system-sleep.md
rename to manual/36-system-sleep.md
diff --git a/manual/36-hardware-authentication.md b/manual/37-hardware-authentication.md
similarity index 100%
rename from manual/36-hardware-authentication.md
rename to manual/37-hardware-authentication.md
diff --git a/manual/37-fonts.md b/manual/38-fonts.md
similarity index 60%
rename from manual/37-fonts.md
rename to manual/38-fonts.md
index d3df645f..4e4016f3 100644
--- a/manual/37-fonts.md
+++ b/manual/38-fonts.md
@@ -6,4 +6,4 @@ Omarchy uses JetBrainsMono Nerd Font as both the terminal and system font by def
 
 You can change this through the _Style > Font_ menu in the Omarchy menu (`Super + Space`). That sets the monospace font everywhere: the terminal, the bar, and anything else that asks for it.
 
-You can install other popular programming fonts via _Install > Style > Font_ in the Omarchy menu.
+You can install other popular programming fonts via _Install > Style > Font_ in the Omarchy menu: Cascadia Mono, Meslo LG Mono, Fira Code, Victor Code, Bitstream Vera Mono, and Iosevka are all one click away, in their Nerd Font versions so the glyphs in the bar and terminal keep working. After installing one, pick it under _Style > Font_.
diff --git a/manual/38-backgrounds.md b/manual/39-backgrounds.md
similarity index 100%
rename from manual/38-backgrounds.md
rename to manual/39-backgrounds.md
diff --git a/manual/39-prompt.md b/manual/40-prompt.md
similarity index 100%
rename from manual/39-prompt.md
rename to manual/40-prompt.md
diff --git a/manual/40-branding.md b/manual/41-branding.md
similarity index 100%
rename from manual/40-branding.md
rename to manual/41-branding.md
diff --git a/manual/41-common-tweaks.md b/manual/42-common-tweaks.md
similarity index 100%
rename from manual/41-common-tweaks.md
rename to manual/42-common-tweaks.md
diff --git a/manual/42-extra-themes.md b/manual/43-extra-themes.md
similarity index 100%
rename from manual/42-extra-themes.md
rename to manual/43-extra-themes.md
diff --git a/manual/43-making-your-own-theme.md b/manual/44-making-your-own-theme.md
similarity index 97%
rename from manual/43-making-your-own-theme.md
rename to manual/44-making-your-own-theme.md
index 1ec10bd3..113d48f0 100644
--- a/manual/43-making-your-own-theme.md
+++ b/manual/44-making-your-own-theme.md
@@ -28,4 +28,4 @@ There's a fully commented `alacritty.toml.tpl.sample` in that folder to copy fro
 
 If you want to distribute your theme so others can use it, you need to put it on a public git server, like GitHub. Then people can install it using _Install > Style > Theme_ in the Omarchy menu using that URL. It's recommended that you follow the naming convention of `omarchy-[themename]-theme`, as the theme will show correctly as just `[themename]` in the theme selection menu after installation.
 
-You can have your theme added to [the extra themes page](42-extra-themes.md) by pinging @tahayvr on [the #omarchy Discord](https://discord.gg/tXFUdasqhY).
+You can have your theme added to [the extra themes page](43-extra-themes.md) by pinging @tahayvr on [the #omarchy Discord](https://discord.gg/tXFUdasqhY).
diff --git a/manual/44-mac-support.md b/manual/45-mac-support.md
similarity index 100%
rename from manual/44-mac-support.md
rename to manual/45-mac-support.md
diff --git a/manual/45-troubleshooting.md b/manual/46-troubleshooting.md
similarity index 82%
rename from manual/45-troubleshooting.md
rename to manual/46-troubleshooting.md
index 9eda0c98..8419efe9 100644
--- a/manual/45-troubleshooting.md
+++ b/manual/46-troubleshooting.md
@@ -2,17 +2,17 @@
 
 ### I broke my system with an update!
 
-First try to [rollback your system](47-system-snapshots.md) the version before your recent update. If that doesn't work, use `omarchy-debug` to share with your problem on #omarchy-help in the Discord. And if all that fails, you can reinstall the defaults configs and packages using `omarchy-reinstall`.
+First try to [rollback your system](48-system-snapshots.md) the version before your recent update. If that doesn't work, use `omarchy-debug` to share with your problem on #omarchy-help in the Discord. And if all that fails, you can reinstall the defaults configs and packages using `omarchy-reinstall`.
 
 ### Why are some apps so large on my display?
 
-Omarchy assumes a 2x high-resolution display, which requires setting `GDK_SCALE` to 2 in `~/.config/hypr/monitors.lua`. But if you're on a 1x display, you can change `local omarchy_gdk_scale = 2` to 1 (and then restart any app that's oversized). See [the manual on monitors](32-monitors.md).
+Omarchy assumes a 2x high-resolution display, which requires setting `GDK_SCALE` to 2 in `~/.config/hypr/monitors.lua`. But if you're on a 1x display, you can change `local omarchy_gdk_scale = 2` to 1 (and then restart any app that's oversized). See [the manual on monitors](33-monitors.md).
 
 For Spotify, you can use `Ctrl + Minus` to shrink the UI (and `Ctrl + Plus` to make it bigger).
 
 ### Why isn't Caps Lock working?
 
-In Omarchy, Caps Lock has been designated to be the xcompose key. That's how you get [quick emojis](06-hotkeys.md#quick-emojis) and [other autocompletions](06-hotkeys.md#quick-completions) done. If you really miss using Caps Lock, you can remap the xcompose key to something else by editing `~/.config/hypr/input.lua`, like setting it to the right alt key:
+In Omarchy, Caps Lock has been designated to be the xcompose key. That's how you get [quick emojis](07-hotkeys.md#quick-emojis) and [other autocompletions](07-hotkeys.md#quick-completions) done. If you really miss using Caps Lock, you can remap the xcompose key to something else by editing `~/.config/hypr/input.lua`, like setting it to the right alt key:
 
 ```
 hl.config({
@@ -30,6 +30,10 @@ Before you reboot, try restarting the offending subsystem on its own. _Update >
 
 Probably because they're not set as the primary output. Click on the speaker icon on the right side of the bar, and it'll open the volume popup where you can pick the output device (and mix per-app volumes too).
 
+### My laptop speakers sound off
+
+On some laptops, Omarchy automatically applies a speaker tuning that corrects the built-in speakers' frequency response. `omarchy audio tuning status` tells you whether one is active on your machine, and `omarchy audio tuning off` turns it off if you'd rather hear the speakers raw.
+
 ### Why can't I login or sudo with my password?
 
 You probably typed it wrong too many times and got locked out. If this is happening on the lock screen, you can hit `CTRL + ALT + F2` to start a new TTY where you can login as root, then run `faillock --reset --user [your-username]`. That'll reset the lockout, and you're good to go.
diff --git a/manual/46-faq.md b/manual/47-faq.md
similarity index 97%
rename from manual/46-faq.md
rename to manual/47-faq.md
index a8f7aa41..b8114558 100644
--- a/manual/46-faq.md
+++ b/manual/47-faq.md
@@ -32,7 +32,7 @@ Run _Update > Timezone_ in the Omarchy menu and pick from the list. If the timez
 
 ### How do I change my DNS, share my Wi-Fi, or check my connection speed?
 
-Those all live in [networking](34-networking.md).
+Those all live in [networking](35-networking.md).
 
 ### How do I check how fast my disk is?
 
@@ -76,4 +76,4 @@ Or run _Remove > Preinstalls_ to sweep out all the preinstalled extras — web a
 
 ---
 
-For errors and broken bits, see [the Troubleshooting section](45-troubleshooting.md).
+For errors and broken bits, see [the Troubleshooting section](46-troubleshooting.md).
diff --git a/manual/47-system-snapshots.md b/manual/48-system-snapshots.md
similarity index 100%
rename from manual/47-system-snapshots.md
rename to manual/48-system-snapshots.md
diff --git a/manual/48-security.md b/manual/49-security.md
similarity index 100%
rename from manual/48-security.md
rename to manual/49-security.md
diff --git a/manual/49-omarchy-on.md b/manual/50-omarchy-on.md
similarity index 100%
rename from manual/49-omarchy-on.md
rename to manual/50-omarchy-on.md
diff --git a/manual/50-dual-boot-install.md b/manual/51-dual-boot-install.md
similarity index 100%
rename from manual/50-dual-boot-install.md
rename to manual/51-dual-boot-install.md
diff --git a/manual/51-unattended-installs.md b/manual/52-unattended-installs.md
similarity index 100%
rename from manual/51-unattended-installs.md
rename to manual/52-unattended-installs.md