Skip to content

Commit b72eb84

Browse files
jguiceclaude
andcommitted
docs: reword Cmd+Q + fix model size discrepancy
Three fixes surfaced by an audit pass: - "Cmd+Q the menu-bar icon" asked the reader to do something that isn't how the UI works — you pick "Quit utter" from the menu. Reworded the three instances (README, CONFIGURATION twice). - BACKLOG said ~640 MB for the bundled-model-as-release-asset item; README and INSTALL both say ~650 MB. Aligned BACKLOG to 650. - Re-verified the troubleshooting anchor link to README's macOS section — GitHub slugifies "## macOS (Apple Silicon)" to #macos-apple-silicon (parens dropped), which is what the link already uses. No fix needed. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 25eb7d7 commit b72eb84

3 files changed

Lines changed: 4 additions & 4 deletions

File tree

BACKLOG.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ about discoverability and auto-updates:
4747
- **AUR package (Arch).**
4848
- **Flatpak.** Probably painful because of /dev/uinput and /dev/input
4949
access requirements — Flatpak sandboxes heavily restrict both.
50-
- **Bundle model as a GitHub release asset.** ~640 MB fits under the
50+
- **Bundle model as a GitHub release asset.** ~650 MB fits under the
5151
2 GB-per-asset limit. Acts as a mirror if the HF repo ever disappears.
5252
- **In-app update check.** Utter daemon could compare its running
5353
version to the latest GitHub release and `notify-send` when a new

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ Local, no-cloud push-to-talk dictation for **macOS and Linux**. Hold a key, spea
1717
3. Launch `utter.app`. A first-run window walks you through three permission prompts (Microphone, Input Monitoring, Accessibility). The menu-bar icon appears once all three land.
1818
4. Hold **Right Cmd (⌘)**, speak, release. Text pastes into your focused window.
1919

20-
**Change the PTT key:** open Terminal, run `/Applications/utter.app/Contents/MacOS/utter set-key`, press and hold the key you want, release. Cmd+Q the menu-bar icon and relaunch to apply.
20+
**Change the PTT key:** open Terminal, run `/Applications/utter.app/Contents/MacOS/utter set-key`, press and hold the key you want, release. Pick **Quit utter** from the menu-bar icon and relaunch the app to apply.
2121

2222
### Linux (Fedora, RHEL, Rocky, Debian, Ubuntu — `x86_64` / `aarch64`)
2323

docs/CONFIGURATION.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ Edit it by hand, via `utter set-key` for the PTT key, or (on macOS) via the menu
1515
# Linux
1616
systemctl --user restart utter-daemon utter-watcher
1717

18-
# macOS: Cmd+Q from the menu bar icon, then reopen utter.app
18+
# macOS: pick "Quit utter" from the menu-bar icon, then reopen utter.app
1919
```
2020

2121
Default contents:
@@ -72,7 +72,7 @@ Precedence: **CLI flag > env var > config file > default.**
7272

7373
On macOS, `rightmeta` / `rightcmd` → Right Cmd, `rightoption` / `rightalt` → Right Option, `capslock` → Caps Lock, function keys → F1..F24.
7474

75-
After hand-editing the config, restart: `systemctl --user restart utter-watcher` (Linux) or Cmd+Q + relaunch (macOS).
75+
After hand-editing the config, restart: `systemctl --user restart utter-watcher` (Linux), or pick **Quit utter** from the menu-bar icon and relaunch the app (macOS).
7676

7777
`utter set-key --dry-run` detects the key and reports the canonical name without writing the config — useful for figuring out how a remapped key (QMK / VIA / Karabiner) shows up on your system.
7878

0 commit comments

Comments
 (0)