它是开源 FreeDV 数字语音的桌面图形客户端，配合电台和声卡就能工作

21次阅读

获取下载链

微信关注「软件教程管家」公众号，回复 freedv-gui

freedv-gui解决的是短波爱好者的一个实际需求：在 HF 频段上用数字语音通联，但不想被昂贵的专用设备或封闭软件绑住。它是开源 FreeDV 数字语音的桌面图形客户端，配合电台和声卡就能工作。本文讲清楚它是什么、怎么上手、哪些平台坑要提前知道。

在 GitHub 查看 freedv-gui

GitHub 国内访问较慢，如打不开可多刷新几次。

项目信息一览

项目	内容
项目名	freedv-gui
定位	面向 HF 无线电的开源数字语音桌面应用
通信方式	FreeDV 数字语音，适合窄带短波链路
实现语言	C 语言桌面图形应用
构建系统	CMake，依赖 codec2 共享库完成编解码
音频后端	macOS 用 Core Audio，Linux 用 PulseAudio 接口，Windows 用 WASAPI，其他平台可用 PortAudio
电台集成	支持与数类无线电设备直接集成，具体型号见项目集成说明
配套资料	用户手册、第三方代码说明、代码签名说明、调制音频测试文件

上手指南：先通音频，再接电台

上手顺序别搞反。先让软件和声卡正常出声、能编解码，再去接电台；音频链路没通就接电台，出了问题根本分不清是音频还是电台的锅。

确认平台与依赖：Linux 用户先确认发行版里的 codec2 共享库名称和链接配置，缺依赖后面全是报错。
按文档构建或安装：Linux 从源码构建，Windows 可走交叉编译流程，构建细节以项目文档为准。
选对音频后端：按自己的系统选 Core Audio、PulseAudio 接口、WASAPI 或 PortAudio，先在软件里确认输入输出设备都识别到了。
用测试文件验证：用项目提供的调制音频测试文件先验证编解码链路，确认声音能正常处理再上电台。
接电台并小功率试通联：按集成说明接自己的电台型号，先小功率试一次，确认收发都正常再正常使用。
记下自己的配置：音频设备、后端选择、电台型号和接线方式记下来，下次重装或换机器不用重新摸索。

三个卡点要提前知道。第一，Linux 依赖不能少：Linux 安装需要额外提供 codec2 共享库，部署前必须确认发行版中的依赖名称和链接配置。第二，Wayland 下窗口位置受限：在使用 Wayland 的 Linux 发行版或桌面环境中，窗口会始终打开在屏幕中央，介意窗口位置的人要先接受这一点，或评估其他窗口方案。第三，macOS 上跑 Windows 构建流程行不通：据官网说明，当前 Windows 构建流程在 macOS 上因 CMake 使用错误的库后缀而无法工作，macOS 用户不要在这条路上浪费时间。

版本与获取方式：先给结论

获取方式	适合谁	注意点
Linux 源码构建	有 Linux 环境、愿意自己编译的绝大多数用户	先装好 codec2 共享库和平台依赖
Windows 交叉编译	需要在 Windows 上用的开发者	要求 Linux 环境、CMake 3.25.0 或更高版本、LLVM MinGW 与 NSIS
源码研究	想研究数字语音实现或电台集成的人	集成细节见源码里的集成说明文档

结论先行：Linux 用户直接走源码构建，Windows 用户走交叉编译流程。两条路都不建议跳过测试文件验证这一步，音频链路先通，再接电台，这是最省时间的顺序。

装完先确认的三个检查点

音频设备检查：输入输出设备是否都被正确识别，采样与后端选择是否与声卡匹配，错配会在通联时表现为无声或杂音。
编解码检查：用调制音频测试文件验证编解码链路，确认声音处理正常，不要直接拿真实通联当第一次测试。
电台集成检查：自己的电台型号是否在集成范围内，控制方式和接线是否按集成说明接对，接错先查文档再查线。

适合谁，不适合谁

适合已经有 HF 无线电设备、希望使用带图形界面的 FreeDV 客户端的无线电爱好者，也适合想从源码编译 Linux 与 Windows 程序、研究数字语音桌面客户端构建方式的开发者。项目提供了用户手册、集成说明和测试文件，动手验证的资料比较齐全。

不适合三类场景：一是不想自己处理构建依赖、只想下载即用的用户，Linux 构建需要手动确认 codec2 共享库等依赖；二是部署环境主要是 Wayland 且对窗口位置有硬性要求的场景，窗口居中问题目前要接受；三是想在 macOS 上跑 Windows 构建流程的人，据官网说明这条路目前因 CMake 库后缀问题走不通。