Skip to content
goodrootPublic

About

Native speech-to-text for Linux - Fast, accurate, private, and hackable system-wide dictation

Topics

Resources

Stars

1.3k stars

Watchers

11 watching

Forks

Latest commit

 

History

1,375 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

hyprwhspr

Native speech-to-text for Linux - Fast, accurate, private and hackable system-wide dictation

instant performance | Cohere / Parakeet / Whisper / Qwen3-ASR / ElevenLabs / REST API | stylish visuals

Supports NixOS, Arch, Debian, Ubuntu, Fedora, openSUSE and more

hyprwhspr.com

531586476-2570002a-391b-4e73-b449-2c6b99ea1303.mp4

  • Built for Linux - Native AUR package for Arch, or use Debian/Ubuntu/Fedora/openSUSE/NixOS
  • Very fast defaults - Nearly instant and accurate performance via in-memory models
  • Offline and private - Transcription never leaves your machine. Cloud APIs are fully optional.
  • Latest models - Cohere Transcribe? Orukeet? Parakeet TDT V3? Qwen3-ASR? Latest and greatest
  • GPU memory efficient - Limit or zero memory usage easily, more for other local models
  • onnx-asr for wild CPU speeds - No GPU? Optimized for great speed on any hardware
  • Strong CJK - Qwen3-ASR for Chinese, Japanese and Korean
  • Translation - Translate non-English to English with a single config
  • REST API or websockets - Secure, fast wires to top clouds like Gemini, ElevenLabs, Deepgram
  • Live streaming - Self-host NeMo or Phonon: watch words form, or type as you speak (experimental)
  • Themed visualizer - Visualizes your voice, will automatch Omarchy and Noctalia themes
  • Word overrides and prompts - Custom hot keys, common words, and more
  • Multi-lingual - Great performance in many languages
  • Long form mode with saving - Pause, think, resume, pause: submit... Bam!
  • Auto-paste anywhere - Instant paste into any active buffer, or even auto enter (optional)
  • Audio ducking 🦆 - Reduces or pauses other audio on record (optional)

Why hyprwhspr? There are a lotta dictation apps. This one is built ground-up for performance and stability: your hardware will auto-optimize to the best possible accuracy and speed. Actively maintained, at the leading edge, fully featured, strictly offline unless you use an API, and works on both Wayland and X11.


Quick start

Prerequisites

  • Linux with systemd (Arch, Debian, Ubuntu, Fedora, openSUSE, NixOS etc.)
  • Python 3.11-3.14
  • Wayland or X11 session (GNOME, KDE Plasma, Sway, Hyprland, Niri, etc.).
  • Clipboard/window tools:
    • wl-clipboard and wtype on Wayland
    • xdotool as a fallback for Sway XWayland apps like Steam and Wine
    • python-pyperclip, xclip, xdotool, and xprop on X11 (installed by the dependency script)
  • Waybar or Noctalia (optional, for status bar)
  • gtk4 + PyCairo (optional, for visualizer)
  • NVIDIA GPU (optional, for CUDA acceleration)
  • AMD/Intel GPU / APU (optional, for Vulkan acceleration)

Install


Arch Linux

On the AUR:

# Install for stable
yay -S hyprwhspr

# Or install for bleeding edge
yay -S hyprwhspr-git

Then run the interactive setup:

hyprwhspr setup

Ubuntu, Debian, Fedora, openSUSE

curl -fsSL https://hyprwhspr.com/install.sh | bash

Installs dependencies and the latest release, then walks you through setup.

Manual install
# Clone the repo
git clone https://github.com/goodroot/hyprwhspr.git
cd hyprwhspr

# Install dependencies for your distro
./scripts/install-deps.sh

# Run interactive setup
./bin/hyprwhspr setup

Nix and NixOS (beta)

Use the Nix flake and NixOS module for x86_64 Linux with Whisper.cpp CPU transcription.

We'd appreciate issue reports and requests!


Setup: pick a backend, review your preferences and choose desktop integrations. Setup asks before changing your bar or desktop shortcuts. Backend and model downloads can take several minutes. Follow the final checks and any remaining steps before trying dictation.

Want to choose everything? Answer no to recommended settings.

For automatic backend selection and default settings:

hyprwhspr setup auto

Authentication may still ask for your password.

First use

Ensure your microphone of choice is available in audio settings!

  1. Log out and back in if setup asked you to
  2. Press Super+Alt+D to start dictation - beep!
  3. Speak naturally
  4. Press Super+Alt+D again to stop dictation - boop!
  5. Bam! Text appears in active buffer!

Recording indicator: when enabled and its dependencies are available, supported desktops show an overlay or a status notification. Noctalia / Omarchy can match the overlay to your shell theme. See Themed visualizer for details.

Any snags, please create an issue.

Updating

# Arch: update via your AUR helper
yay -Syu hyprwhspr

# Installed with install.sh
hyprwhspr update

# Old git-clone installs: re-run the installer once to move to releases
curl -fsSL https://hyprwhspr.com/install.sh | bash

# Either way, setup is idempotent if you need to re-run it
hyprwhspr setup

Managed release rollout and recovery: installation guide.

CLI commands

  • hyprwhspr setup - Interactive initial setup
  • hyprwhspr update [--version VERSION] - Update a managed release
  • hyprwhspr install status - Inspect managed installation state
  • hyprwhspr install repair [--python PATH] - Repair a managed installation
  • hyprwhspr config - Manage configuration (show / show --all / edit / secondary-shortcut)
  • hyprwhspr model - Manage models (download / list / status / unload / reload)
  • hyprwhspr record - External hotkey control (start / stop / toggle / cancel / capture / status / copy-last / paste-last / clear-last)
  • hyprwhspr transcribe INPUT - Transcribe a WAV or MP3 file to stdout (use -o PATH to write a file)
  • hyprwhspr status - Overall status check
  • hyprwhspr validate - Validate installation
  • hyprwhspr test - Test microphone and transcription end-to-end
  • hyprwhspr keyboard - List/test keyboard devices (list / test)
  • hyprwhspr waybar / hyprwhspr noctalia - Manage bar integration
  • hyprwhspr mic-osd - Enable/disable the mic OSD (enable / disable / status)
  • hyprwhspr systemd - Manage systemd services
  • hyprwhspr uninstall - Remove hyprwhspr; preserve settings, credentials and models
  • hyprwhspr uninstall --purge - Also remove recorded personal files (--keep-models preserves models)

Documentation

All of it at hyprwhspr.com/docs, or here:

Getting help

License

MIT License - see LICENSE file.

Contributing

Start with an issue - happy to help! Pull requests best begin there too.

Upvotes on the AUR and/or GitHub stars are also a nice way to show appreciation.


Built with ❤️ in 🇨🇦

About

Native speech-to-text for Linux - Fast, accurate, private, and hackable system-wide dictation

Topics

Resources

Stars

1.3k stars

Watchers

11 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages