Skip to content

Make Superwhisper the default dictation backend - #14620

Closed
nchudleigh wants to merge 3 commits into
omacom:dictation-backendsfrom
nchudleigh:superwhisper-default-dictation
Closed

nchudleigh wants to merge 3 commits into
omacom:dictation-backendsfrom
nchudleigh:superwhisper-default-dictation

Conversation

@nchudleigh

@nchudleigh nchudleigh commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

Four small changes on top of #14552.

  • Superwhisper as the default for new installs. It comes first under Setup > Defaults > Dictation. The first-run invitation reads "Install Dictation with Superwhisper" and runs omarchy-default-dictation superwhisper. Voxtype stays in that menu, and the manual names Superwhisper as the default. Line 17 of the manual no longer calls Superwhisper the alternative.

  • One invitation for existing Voxtype users. A migration installs try-superwhisper.hook as a post-update hook, the way setup-agent.hook reached existing accounts. It runs after the update's shell restart. On a machine with Voxtype and without Superwhisper it sends one notification that starts Superwhisper's installer. New installs mark the migration done, so they never see it.

  • The dictation keys are listed in o.dictation_keys. When someone sets one of Superwhisper's own shortcuts to F9, Right Alt or Super+Ctrl+X, Superwhisper's generated shortcuts.lua can hl.unbind Omarchy's binding for that key instead of both firing. It is one hl.unbind(keys) per key: in Hyprland 0.56.2, unbinding a key's press and release handles one at a time crashes. The Superwhisper side is superultrainc/superwhisper-linux#84. It also re-checks hyprctl binds after reloading and rolls back if another binding still holds the key, so it stays safe on an Omarchy without this list.

  • Superwhisper's own shortcuts use Omarchy's keys, set once. omarchy-install-dictation-superwhisper used to set Superwhisper's toggle to Alt+Space and its hold to none on every selection. That added a second toggle beside Super+Ctrl+X, and re-selecting Superwhisper overwrote any shortcut the user had chosen since. The first setup now sets the toggle to Super+Ctrl+X and the hold to Right Alt. Superwhisper takes those keys over and handles them itself:

    • No process per key press. Omarchy's chain is about 15–20 ms per press on an XPS 14; Superwhisper's in-process binding avoids it.
    • A Right Alt key combination typed quickly (the next key within 80 ms) reaches the app and doesn't start dictation. Omarchy's own Right Alt binding starts dictation on any combination.
    • Escape cancels.

    F9 stays Omarchy's push-to-talk. Later selections leave the shortcuts alone (an omarchy-done marker). A Superwhisper release that refuses Omarchy's keys falls back to Alt+Space / no hold.

Both invitations install superwhisper-bin, so this depends on omacom/omarchy-pkgs#854 being published, as #14552 already does.

Tests:

  • dictation-test.sh checks the key list.
  • try-superwhisper-invitation-test.sh covers the migration installing the hook, one invitation on a Voxtype machine, and no invitation or marker on machines with Superwhisper or without Voxtype.
  • voxtype-invitation-test.sh is updated.
  • dictation-test.sh also covers the first setup taking Omarchy's keys, re-selecting changing nothing, and the Alt+Space fallback.
  • Each commit passes the dictation, invitation, menu, keybinding and migration suites on its own.

Not checked in a live session.

🤖 Generated with Claude Code

superduck00 and others added 3 commits October 8, 2026 14:27
Superwhisper comes first under Setup > Defaults > Dictation, and the first-run
invitation installs it; Voxtype stays a choice in that menu.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A migration installs a post-update hook, which runs after the update's shell
restart and sends one notification on a machine with Voxtype and without
Superwhisper. Clicking it starts Superwhisper's installer.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A backend that binds F9, Right Alt or Super+Ctrl+X itself (Superwhisper's own
shortcuts) can unbind Omarchy's binding through o.dictation_keys instead of
both firing.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@greptile-apps

greptile-apps Bot commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerConfidence Score: 5/5

[Medium impact] The PR appears safe to merge; no actionable issues were found.

Summary

Makes Superwhisper the first dictation choice while keeping Voxtype available.

  • New users receive an invitation that opens Superwhisper’s installer.
  • A migration adds a one-time invitation for existing users with Voxtype but without Superwhisper.
  • o.dictation_keys lists Omarchy’s recording keys so a backend can take them over.
  • Updates the manual and shell tests. No actionable issues were found. Tests were inspected, not run.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart TD
  A[New install] --> B[Mark shipped migrations complete]
  A --> C[Install first-run invitation hook]
  C --> D[Invite user to install Superwhisper]
  E[Existing user updates] --> F[Migration installs upgrade hook]
  F --> G[Restart services]
  G --> H{Voxtype present and Superwhisper absent?}
  H -->|Yes, not previously invited| I[Send upgrade invitation]
  H -->|No| J[Stay quiet]
  D --> K[User clicks invitation]
  I --> K
  K --> L[Open Superwhisper installer in a terminal]
Loading

Reviews (1) · Last reviewed commit: "List the dictation keys so a backend can..." · Reviewed by Greptile

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants