{"id":30700976,"url":"https://github.com/goodroot/hyprwhspr","last_synced_at":"2026-05-28T02:03:34.964Z","repository":{"id":311964354,"uuid":"1045801018","full_name":"goodroot/hyprwhspr","owner":"goodroot","description":" Native speech-to-text for Linux - Fast, accurate and private system-wide dictation","archived":false,"fork":false,"pushed_at":"2026-04-29T14:38:17.000Z","size":2192,"stargazers_count":996,"open_issues_count":2,"forks_count":71,"subscribers_count":8,"default_branch":"main","last_synced_at":"2026-04-29T16:28:52.880Z","etag":null,"topics":["ai","archlinux","cachyos","cohere-ai","debian","dictation","elevenlabs","fedora","hyprland","omarchy","opensuse","parakeet","speech-to-text","translation","ubuntu","waybar","wayland","whisper"],"latest_commit_sha":null,"homepage":"https://hyprwhspr.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/goodroot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"goodroot","patreon":null,"open_collective":null,"ko_fi":"goodroot","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2025-08-27T18:21:15.000Z","updated_at":"2026-04-29T16:22:26.000Z","dependencies_parsed_at":"2025-08-28T03:23:31.757Z","dependency_job_id":"6c45d8a8-8dd1-4e49-8409-d3dd926ca800","html_url":"https://github.com/goodroot/hyprwhspr","commit_stats":null,"previous_names":["goodroot/hyprwhspr"],"tags_count":108,"template":false,"template_full_name":null,"purl":"pkg:github/goodroot/hyprwhspr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goodroot%2Fhyprwhspr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goodroot%2Fhyprwhspr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goodroot%2Fhyprwhspr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goodroot%2Fhyprwhspr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/goodroot","download_url":"https://codeload.github.com/goodroot/hyprwhspr/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goodroot%2Fhyprwhspr/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32618391,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-04T10:08:07.713Z","status":"ssl_error","status_checked_at":"2026-05-04T10:08:02.005Z","response_time":58,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","archlinux","cachyos","cohere-ai","debian","dictation","elevenlabs","fedora","hyprland","omarchy","opensuse","parakeet","speech-to-text","translation","ubuntu","waybar","wayland","whisper"],"created_at":"2025-09-02T13:01:22.836Z","updated_at":"2026-05-25T00:05:25.475Z","avatar_url":"https://github.com/goodroot.png","language":"Python","funding_links":["https://github.com/sponsors/goodroot","https://ko-fi.com/goodroot"],"categories":["Directory","Alternative Implementations"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n    hyprwhspr\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cb\u003eNative speech-to-text for Linux\u003c/b\u003e - Fast, accurate and private system-wide dictation\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    instant performance | Cohere / Parakeet / Whisper / Gemini / ElevenLabs / REST API | stylish visuals\n\u003c/p\u003e\n\n \u003cp align=\"center\"\u003e\n    \u003ci\u003eSupports Arch, Debian, Ubuntu, Fedora, openSUSE and more\u003c/i\u003e\n \u003c/p\u003e\n\n \u003cp align=\"center\"\u003e\n    \u003ci\u003e \u003ca href=\"https://hyprwhspr.com\"\u003ehyprwhspr.com\u003c/a\u003e\u003c/i\u003e\n \u003c/p\u003e\n\nhttps://github.com/user-attachments/assets/4c223e85-2916-494f-b7b1-766ce1bdc991\n\n---\n\n- **Built for Linux** - Native AUR package for Arch, or use Debian/Ubuntu/Fedora/openSUSE\n- **Local, very fast defaults** - Instant, private and accurate performance via in-memory models\n- **Latest models** - Cohere Transcribe? Turbo-v3? Parakeet TDT V3? Latest and greatest\n- **GPU memory efficient** - Limit or zero memory usage easily, more for other local models\n- **onnx-asr for wild CPU speeds** - No GPU? Optimized for great speed on any hardware\n- **Translation** - Translate non-English to English with a single config\n- **REST API or websockets** - Secure, fast wires to top clouds like Gemini, ElevenLabs\n- **Themed visualizer** - Visualizes your voice, will automatch Omarchy theme\n- **Word overides and prompts** - Custom hot keys, common words, and more\n- **Multi-lingual** - Great performance in many languages\n- **Long form mode with saving** - Pause, think, resume, pause: submit... Bam!\n- **Auto-paste anywhere** - Instant paste into any active buffer, or even auto enter (optional)\n- **Audio ducking 🦆** - Reduces system volume on record (optional)\n\n## Quick start\n\n### Prerequisites\n\n- **Linux** with systemd (Arch, Debian, Ubuntu, Fedora, openSUSE, etc.)\n- **Requires a Wayland session** (GNOME, KDE Plasma Wayland, Sway, Hyprland)\n\n- **Waybar** (optional, for status bar)\n- **gtk4 + PyCairo** (optional, for visualizer)\n- **NVIDIA GPU** (optional, for CUDA acceleration)\n- **AMD/Intel GPU / APU** (optional, for Vulkan acceleration)\n\n### Quick start (Arch Linux)\n\nOn the AUR:\n\n```bash\n# Install for stable\nyay -S hyprwhspr\n\n# Or install for bleeding edge\nyay -S hyprwhspr-git\n```\n\nThen run the auto installer, or perform your own:\n\n```bash\n# Run interactive setup\nhyprwhspr setup\n```\n\n**The setup will walk you through the process:**\n\n1. ✅ Configure transcription backend (Cohere Transcribe, Parakeet TDT V3, Whisper, REST API, or Realtime WebSocket)\n2. ✅ Download models\n3. ✅ Configure themed visualizer for maximum coolness (optional)\n4. ✅ Configure Waybar integration (optional)\n5. ✅ Set up systemd user services \n6. ✅ Set up permissions\n7. ✅ Validate installation\n\n### First use\n\n\u003e Ensure your microphone of choice is available in audio settings!\n\n1. **Log out and back in** (for group permissions)\n2. **Press `Super+Alt+D`** to start dictation - _beep!_\n3. **Speak naturally**\n4. **Press `Super+Alt+D`** again to stop dictation - _boop!_\n5. **Bam!** Text appears in active buffer!\n\nAny snags, please [create an issue](https://github.com/goodroot/hyprwhspr/issues/new/choose).\n\n### Updating\n\n```bash\n# Update via your AUR helper\nyay -Syu hyprwhspr\n\n# If needed, re-run setup (idempotent)\nhyprwhspr setup\n```\n\n### Other Linux distros\n\nhyprwhspr can run on any Linux distribution with systemd.\n\n```bash\n# Clone the repo\ngit clone https://github.com/goodroot/hyprwhspr.git\ncd hyprwhspr\n\n# Install dependencies for your distro (Ubuntu, Debian, Fedora, openSUSE)\n./scripts/install-deps.sh\n\n# Run interactive setup\n./bin/hyprwhspr setup\n```\n\nAfter setup, log out and back in for group permissions, then:\n\n```bash\nhyprwhspr status\n```\n\n\u003e Non-Arch distro support is new - please report any snags!\n\n### CLI commands\n\nAfter installation, use the `hyprwhspr` CLI to manage your installation:\n\n- `hyprwhspr setup` - Interactive initial setup\n- `hyprwhspr config` - Manage configuration (`show` / `show --all` / `edit`)\n- `hyprwhspr model` - Manage models (`download` / `list` / `unload` / `reload`)\n- `hyprwhspr status` - Overall status check\n- `hyprwhspr validate` - Validate installation\n- `hyprwhspr test` - Test microphone and transcription end-to-end\n- `hyprwhspr waybar` - Manage Waybar integration\n- `hyprwhspr systemd` - Manage systemd services\n- `hyprwhspr record` - External hotkey control (`start` / `stop` / `toggle`)\n\nFor the full command reference, see the **[Configuration guide](docs/CONFIGURATION.md)**.\n\n## Documentation\n\nFor full configuration and customization, see the **[Configuration guide](docs/CONFIGURATION.md)**.\n\n- [Minimal configuration](docs/CONFIGURATION.md#minimal-configuration)\n- [Recording modes](docs/CONFIGURATION.md#recording-modes) -- toggle, push-to-talk, auto, long-form\n- [Custom hotkeys](docs/CONFIGURATION.md#custom-hotkeys) -- key support, secondary shortcuts, Hyprland bindings\n- [Backends](docs/CONFIGURATION.md#backends) -- Cohere Transcribe, Parakeet, Whisper, REST API, Realtime WebSocket\n- [GPU resource management](docs/CONFIGURATION.md#gpu-resource-management) -- unload/reload model to free VRAM\n- [Audio and visual feedback](docs/CONFIGURATION.md#audio-and-visual-feedback) -- visualizer, audio feedback, ducking\n- [Text processing](docs/CONFIGURATION.md#text-processing) -- word overrides, filler words, symbol replacements\n- [Paste and clipboard behavior](docs/CONFIGURATION.md#paste-and-clipboard-behavior) -- paste mode, non-QWERTY, auto-submit\n- [Integrations](docs/CONFIGURATION.md#integrations) -- Waybar, Hyprland bindings, external hotkey systems\n- [Troubleshooting](docs/CONFIGURATION.md#troubleshooting)\n\n## Getting help\n\n1. **Check logs**: `journalctl --user -u hyprwhspr.service` `journalctl --user -u ydotool.service`\n2. **Verify permissions**: Run the permissions fix script\n3. **Test components**: Check ydotool, audio devices, whisper.cpp\n4. **Report issues**: [Create an issue](https://github.com/goodroot/hyprwhspr/issues/new/choose) - logging info helpful!\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file.\n\n## Contributing\n\nCreate an issue, happy to help!  \n\nFor pull requests, also best to start with an issue.\n\nIf you want, compute credits from [opub.dev](https://opub.dev/github/goodroot/hyprwhspr) are always welcome!\n\n---\n\n**Built with ❤️ in 🇨🇦**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoodroot%2Fhyprwhspr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoodroot%2Fhyprwhspr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoodroot%2Fhyprwhspr/lists"}