Linux · Wayland

$ hyprwhspr

System-wide speech‑to‑text.
Local models. Secure Cloud providers. Fully featured. Top performance.

View on GitHub Quick install

hyprwhspr ● idle ⏺ recording ◌ processing ✓ done

❯ Open a pull request for the feature branch.

❯ Write unit tests for the auth module.

❯ Deploy to staging and monitor the logs.

── Features

◈

Cutting-edge local

Ships with support for Parakeet TDT V3, Cohere Transcribe, and the full Whisper family. On CPU? onnx-asr delivers wild speeds without a GPU. Models stay hot in memory.

◎

GPU-intelligent

Auto-detects NVIDIA CUDA, AMD/Intel Vulkan, or falls back to CPU. Unload the model from VRAM on demand — free resources, then reload instantly without restarting the service.

✦

Private by default

Local inference means nothing leaves your machine. When you do reach for cloud — OpenAI, ElevenLabs, and more — credentials are stored securely and never touch config files.

🦆

Audio ducking

System volume steps down while you record, back up when you're done.

⏺

Four recording modes

Toggle, push-to-talk, auto (tap vs. hold), and long-form with pause and save.

⌨

Paste anywhere

Text injects into any active buffer via ydotool. Auto-submit optional.

◉

Themed visualizer

Mic-OSD overlay that auto-matches your Omarchy theme. Looks great.

⊞

Waybar tray

Live status indicator: idle, recording, processing, error — all at a glance.

◈

Multi-lingual

Strong performance across many languages. Optional translate-to-English mode.

✎

Text processing

Word overrides, filler word removal, symbol replacements, custom prompts.

⇌

WebSocket streaming

Stream in near realtime via 11Labs, OpenAI Realtime API or similar services.

❖

Works everywhere

Hyprland, GNOME, KDE Plasma, Sway — any Wayland compositor with systemd.

⟁

Free and open source, forever. For the people!

MIT licensed. No subscriptions, no telemetry, no monetization — ever.

MIT License ↗

── Install

Arch Linux

 # stable 
 $ yay -S hyprwhspr 
 # bleeding edge 
 $ yay -S hyprwhspr-git 

Debian · Ubuntu · Fedora · openSUSE

 # clone 
 $ git clone
                                        https://github.com/goodroot/hyprwhspr.git
                                        ~/hyprwhspr 
 # install deps, then set up 
 $ cd ~/hyprwhspr &&
                                        ./scripts/install-deps.sh 
 $ ./bin/hyprwhspr setup 

then, on either path

$ hyprwhspr setup ── interactive wizard

── Writing

guide