哪种安装方式最适合你?Vocalinux Linux 离线语音输入 9 种打包格式完整指南:AppImage、Flatpak、Snap、Nix 【免费下载链接】vocalinuxFree, open-source, 100% offline voice dictation for Linux. Speak and type anywhere via whisper.cpp, Whisper VOSK engines, GPU-accelerated, works on X11 Wayland!项目地址https://gitcode.com/gh_mirrors/vo/vocalinux点击查看免费下载Vocalinux是一款面向 Linux 的免费、开源、100% 离线语音输入voice dictation工具按住快捷键说话识别出的文字会直接落到当前焦点窗口。它内置 whisper.cpp、OpenAI Whisper、VOSK、Parakeet 等本地引擎支持 Vulkan GPU 加速同时兼容 X11 与 Wayland。目前官方提供9 种安装方式本文从适用系统、GPU 支持、更新机制、权限配置 4 个维度逐一横评帮你在 1 分钟内选到最合适的那一种。快速选型哪种安装方式适合你你的情况推荐方式一句话理由Ubuntu 24.04 / Debian 12 / Fedora 42install.sh 脚本官方推荐自动检测 GPU、自动下载模型1–2 分钟装完Arch / Manjaro 用户AUR一条命令yay -S vocalinux系统原生集成NixOS 用户Nix flake声明式安装官方提供 NixOS / Home Manager 模块Ubuntu 22.04、Debian 12 等较老系统AppImage单文件便携自带 Vulkan GPU 推理对 Python 版本要求最宽松不可变系统 / 非主流发行版Flatpak沙盒隔离flatpak update一键自动更新偏好 Snap 商店生态Snap--edge 渠道商店统一管理权限可视化想完全掌控安装过程PyPI / 源码pip 或 git 克隆自由组合引擎 基础要求Linux X11 或 Wayland 麦克风install.sh 与 PyPI 路线要求发行版自带Python 3.11Ubuntu 22.04 / Debian 11 不满足可选 AppImage 或 Flatpak。磁盘约 200MB内存 4GB 起。完整支持矩阵见 docs/DISTRO_COMPATIBILITY.md。9 种安装方式逐一横评步骤、GPU 支持、更新机制1️⃣ install.sh 安装脚本官方推荐新手首选适合Ubuntu 24.04、Debian 12、Fedora 42、Arch、openSUSE Tumbleweed 等支持 Python 3.11 的发行版。脚本会自动完成全套工作检测发行版与 GPU/VulkanAMD、Intel、NVIDIA 均可、安装默认引擎 whisper.cpp约 1–2 分钟无需庞大的 PyTorch 依赖、下载约 74MB 的 tiny 模型带校验和验证、按需安装 Silero 神经 VAD并写好桌面菜单项与启动器。# 克隆仓库后直接运行推荐先审阅脚本内容 ./install.sh # 交互模式 ./install.sh --auto # 全自动默认 whisper.cpp ./install.sh --auto --enginevosk # 低内存机型可选 体验最完整依赖、模型、桌面集成一次到位更新时重跑脚本即可配置和模型会保留 唯一门槛发行版必须自带 Python 3.112️⃣ AppImage 便携安装老系统与零污染首选适合不想装系统包、想拷贝到 U 盘随身用或系统 Python 版本不够 3.11 的用户。从 Releases 下载Vocalinux-*-x86_64.AppImage或aarch64赋予执行权限即可运行chmod x Vocalinux-*-x86_64.AppImage ./Vocalinux-*-x86_64.AppImage 自带Vulkan 版 whisper.cpp并直接调用宿主机 GPU 驱动是较老系统上唯一能吃到 GPU 加速的方式 兼容性门槛低glibc 2.35 即可Debian 12、Ubuntu 22.04、Fedora 36、Arch、Tumbleweed 宿主机仍需文本注入工具X11 用xdotoolWayland 用wtype/ydotool等 无自动更新每次发新版都要手动下载新文件替换3️⃣ .deb / .rpm 发行版原生包Debian、Ubuntu、Fedora适合习惯用apt/dnf管理软件的用户。.deb支持 Debian 12、Ubuntu 24.04.rpm支持 Fedora。sudo apt install ./vocalinux_*_amd64.deb # Debian / Ubuntu sudo dnf install ./vocalinux-*.x86_64.rpm # Fedora 薄包设计Python、GTK、PyGObject 全部来自发行版包内仅内置pywhispercpp和pynput依赖由apt/dnf自动解析干净无冲突 包内 whisper.cpp 为CPU 版无 Vulkan 构建无自动更新目前也没有 PPA / COPR 仓库⚠️ Wayland 下全局快捷键走 evdev需要把用户加入input组sudo usermod -aG input $USER后重新登录安装包不会替你执行这一步4️⃣ AUR 一条命令安装Arch / ManjaroArch 系用户的最短路径详见 docs/AUR.mdyay -S vocalinux # 最新 release yay -S vocalinux-git # 社区包跟踪 main 分支 与系统包管理器完全融合yay -Syu时顺带升级⚠️ AUR 中的python-pywhispercpp系列仍是 1.4.x 且没有 Vulkan 构建包——想要 GPU 加速请改用 install.sh 或 AppImage⚠️vocalinux、vocalinux-binAppImage 变体、vocalinux-git三者互相冲突只装其一5️⃣ Flatpak 安装沙盒隔离 自动更新适合不可变系统、非主流发行版以及追求装完就不管的用户。Vocalinux不在 Flathub而是走官方自托管的 VocaHQ 远程仓库首次添加远程后即可flatpak install vocahq com.vocalinux.Vocalinux flatpak update # 每次发新版都会自动收到 内置 whisper.cpp Vulkan Silero VAD官方远程支持flatpak update自动更新Releases 里 sideload 的.flatpak捆绑包则不能 配置与模型独立存放在~/.var/app/com.vocalinux.Vocalinux/卸载即干净⚠️ Wayland 下内置快捷键需要/dev/input设备权限若不想给设备权限可在Settings → Shortcuts开启 External Activation绑定桌面快捷键调用 D-BusToggle仅支持 toggle 模式细节见 packaging/flatpak/README.md清单文件为 packaging/flatpak/com.vocalinux.Vocalinux.yml6️⃣ Snap 安装Ubuntu Snap Store--edge 渠道sudo snap install vocalinux --edge安装后按需在终端手动放行权限也可在 GUI 权限页操作sudo snap connect vocalinux:audio-record # 麦克风 sudo snap connect vocalinux:raw-input # 全局快捷键evdev sudo snap connect vocalinux:hardware-observe # 枚举键盘 商店统一管理snap refresh vocalinux完成更新 Wayland 下打字走 RemoteDesktop 门户首次听写时合成器只询问一次⚠️ 当前配方不含uinput插件商店拒绝了该高权限授予因此没有 ydotool 兜底KDE Plasma 用户若遇到 KWin 门户大小写错乱请在系统设置里把 Virtual Keyboard 设为 IBus Wayland配方见 snap/snapcraft.yaml7️⃣ Nix flake 安装NixOS / Nix 用户官方途径标准 install.sh 并不支持 NixOSNix flake 才是官方答案nix run github:VocaHQ/vocalinux # 直接试运行 nix profile install github:VocaHQ/vocalinux # 安装到 profileNixOS 用户引入vocalinux.nixosModules.vocalinux模块后一行programs.vocalinux.enable true;即可完成声明式安装模块还会自动启用hardware.uinputHome Manager 用户有对应的homeManagerModules.vocalinux。 GTK、PyGObject 来自 nixpkgspywhispercpp由 PyPI sdist 构建所有注入工具xdotool、wtype、ydotool、剪贴板工具等都挂进 PATH开箱即用 内置 whisper.cppVulkan 便携构建 神经 VADnix profile upgrade更新 未打包 vosk / OpenAI Whisper / Parakeet / Faster Whisper 引擎8️⃣ PyPI 安装pip / pipx高级用户完全控制适合想自己掌握依赖细节、或走 pip-only 工作流的用户完整步骤见 docs/INSTALL_MANUAL.md。关键前提GTK、PortAudio、文本注入工具这类系统库 pip 装不了必须先用apt/dnf/zypper装好各发行版完整清单见 scripts/distro-package-map.yaml然后python3 -m venv ~/.local/share/vocalinux-pypi/venv --system-site-packages source ~/.local/share/vocalinux-pypi/venv/bin/activate pip install vocalinux # 可选 extras: pip install vocalinux[vad] # 神经 VAD / [vosk] / [faster_whisper] / [parakeet] vocalinux 引擎组合自由可只装需要的 extras也支持pipx install vocalinux 模型需安装后在 Settings 里手动下载桌面集成需自行配置9️⃣ 源码安装贡献者与自定义构建克隆仓库官方镜像地址git clone https://gitcode.com/gh_mirrors/vo/vocalinux cd vocalinux ./install.sh --enginewhisper_cpp # 可自由指定引擎 ./install.sh --dev # 开发模式可编辑安装 测试工具适合需要改代码、跑测试或做自定义构建的开发者流程见 CONTRIBUTING.md。装完之后更新机制对比与常用操作安装方式如何更新install.sh重跑安装脚本配置与模型自动保留AppImage从 Releases 下载新文件替换.deb / .rpm下载新版安装包重新安装无自动更新AURyay -S vocalinuxFlatpakflatpak updateVocaHQ 远程自动同步Snapsnap refresh vocalinuxNixnix profile upgradePyPI / 源码在同一 venv 重装 /git pull后重跑 install.shVocalinux 还会在后台定期检测新版本托盘菜单出现Update Available...入口Settings → About 页面可查看当前版本、渠道与最新 Release装好后第一次听写按住默认快捷键新安装默认为Right Alt推键说话即可识别文本会实时注入焦点窗口日常使用中最常用的是Settings → Speech Model页面简单模式下选语言与速度/精度展开Advanced可切换引擎whisper.cpp / Whisper / VOSK / Parakeet 等、模型大小与量化规格卸载与迁移源码头安装可用./uninstall.sh --keep-config --keep-data保留配置与模型其余方式分别用apt/dnf remove、flatpak uninstall、snap remove vocalinux即可。各方式的配置文件默认在~/.config/vocalinux/config.json、模型在~/.local/share/vocalinux/Flatpak 在~/.var/app/com.vocalinux.Vocalinux/下想换安装方式时留意这两处即可。FAQVocalinux 安装常见问题Q1哪些方式有 GPU 加速install.sh、AppImage、Flatpak、Nix 四种都内置Vulkan 版 whisper.cppAMD / Intel / NVIDIA 均可vulkaninfo --summary可自检.deb / .rpm 是 CPU 版AUR 目前暂无 Vulkan 构建包。Q2Ubuntu 22.04 / Debian 11 能用吗Python 版本低于 3.11 门槛install.sh 与 PyPI 路线不可用可选AppImageglibc 2.35 门槛以下也不行时用 Flatpak或 Flatpak。Q3Wayland 下快捷键没反应系统包 / 源码安装确认用户已加入input组并重新登录Flatpak需要/dev/input设备权限或改用 External Activation 桌面快捷键Snap执行sudo snap connect vocalinux:raw-input排查清单见 docs/TROUBLESHOOTING.mdQ4可以装完后换一种方式吗可以。先卸载旧方式保留配置目录再按新方式安装即可模型文件较大迁移时可直接从旧位置拷贝到对应数据目录。相关文档与源码参考安装总指南docs/INSTALL.md手动安装 / PyPI 详细步骤docs/INSTALL_MANUAL.mdAUR 打包说明docs/AUR.mdFlatpak 打包远程仓库、无设备权限运行packaging/flatpak/README.mdNix flake 与 NixOS / Home Manager 模块packaging/nix/README.md更新与发行说明docs/UPDATE.md发行版兼容性矩阵docs/DISTRO_COMPATIBILITY.md各发行版系统依赖清单scripts/distro-package-map.yaml安装脚本源码install.sh · 卸载脚本uninstall.sh赞分享【免费下载链接】vocalinuxFree, open-source, 100% offline voice dictation for Linux. Speak and type anywhere via whisper.cpp, Whisper VOSK engines, GPU-accelerated, works on X11 Wayland!项目地址https://gitcode.com/gh_mirrors/vo/vocalinux点击查看免费下载相关推荐AI 逆向工程完整指南如何让 AI Agent 免源码看清二进制行为AI 逆向工程完整指南如何让 AI Agent 免源码看清二进制行为 想知道竞品 App 的某个功能是怎么实现的手里却只有一份没有源码的二进制文件——这是很逆向工程MCP 服务AI 技能实测edge-tts语音合成质量对比哪种音频格式最适合你的场景实测edge tts语音合成质量对比哪种音频格式最适合你的场景 还在为TTS语音合成的音质和文件大小纠结作为开发者或运营人员你是否经常遇到这样的困境语音音频如何在Windows、macOS和Linux上快速安装SonoraBrew、AUR、Flatpak、Nix等6种方式完整指南如何在Windows、macOS和Linux上快速安装SonoraBrew、AUR、Flatpak、Nix等6种方式完整指南 Sonora 是一款用 Rust上一篇AWX REST API Reference 深度解析Swagger UI 驱动的交互式 API 文档与 OpenAPI Schema 生成机制下一篇ScePSX问题追踪GitHub Issues管理与优先级排序创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考