goodroot/hyprwhspr

hyprwhspr – 快速、隐私的 Linux 语音转文字工具

简介

• 这是一款原生 Linux 应用程序，可将口述内容转换为文字，适用于任何可输入文字的地方。它作为全系统服务运行，并可将转录内容直接粘贴到当前窗口。
• 专为性能设计：可使用运行于内存中的设备端模型（Whisper、Cohere、Parakeet、Qwen3-ASR 等），或选择调用云端 API。
• 适用于 Wayland 与 X11 桌面（Hyprland、Sway、KDE、GNOME 等），并可与 Waybar 或 Noctalia 等状态栏集成。

主要功能

功能	说明
即时、精准转录	将模型加载到 RAM（或使用 CPU 的 ONNX）以实现近乎实时的听写。
离线优先 / 隐私保护	所有本地模型均将音频保留在您的机器上；云端服务为选用。
多种后端支持	可选择 Cohere Transcribe、Parakeet TDT V3、Whisper、Qwen3-ASR 或通用的 REST/WebSocket API。
GPU 高效能	支持 CUDA (NVIDIA) 或 Vulkan (AMD/Intel) 加速，并提供限制或降低 GPU 内存使用量的选项。
中日韩支持与翻译	Qwen3-ASR 处理中文/日文/韩文；内置翻译功能可将非英语语音转换为英语。
实时视觉反馈	符合您桌面主题（Omarchy、Noctalia 等）的屏幕可视化工具。
热键控制与自动粘贴	默认 Super+Alt+D 切换听写；结果可自动粘贴或复制到剪贴板。
音频闪避 (Ducking)	录音时可选择降低其他音频音量。
REST API / WebSocket	将服务暴露给其他程序或 Gemini、ElevenLabs 等云端供应商。
长篇模式	暂停并恢复听写，并保存中间结果。

如何获取

• Arch Linux – 从 AUR 安装 (hyprwhspr 或 hyprwhspr-git)。
• 其他发行版 – 执行单行安装脚本：curl -fsSL https://hyprwhspr.com/install.sh | bash。
• 也支持通过仓库脚本进行手动安装。

典型工作流程

1. 执行 hyprwhspr setup – 交互式向导将引导您选择转录后端、下载模型并配置可视化工具/状态栏集成。
2. 注销并重新登录以应用组权限。
3. 按下热键 (Super+Alt+D) 开始听写；自然说话即可。
4. 再次按下热键停止 – 转录文字将出现在当前焦点窗口中，或自动粘贴。

命令行工具

• hyprwhspr record – 从终端开始/停止听写。
• hyprwhspr transcribe <file> – 转录音频文件。
• hyprwhspr model – 下载、列出、卸载或重新加载模型。
• hyprwhspr config – 查看或编辑配置文件。
• 服务管理命令 (hyprwhspr systemd, hyprwhspr uninstall 等)

文档与帮助

• 完整文档请见 https://hyprwhspr.com/docs – 包含配置、录音模式、后端详细信息及疑难解答。
• 日志可通过 journalctl --user -u hyprwhspr.service 获取。
• 问题可在 GitHub 上提出。

授权

• MIT License。

总结 hyprwhspr 是一款真正且持续维护的开源 Linux 语音转文字工具，专注于低延迟、保护隐私的听写功能，并提供灵活的后端选择与桌面集成特性。