Jack Meter Bridge

Windows 上基于 JUCE 和 JACK2 的多通道音频电平与响度监测工具。通过 JACK Patchbay 将任意音频源连接到应用的输入端口，即可查看每个通道的 Peak、RMS、dBTP、Momentary LUFS、Short-term LUFS、Integrated LUFS 与 LRA。

功能

• 每通道七项实时电平/响度读数与分段固色仪表。
• JACK 输入端口动态管理；通道名会同步显示在 JACK Patchbay。
• 单通道与全局 Reset，支持按静音阈值和持续时间自动重置。
• 每通道 Record 开关：按设置间隔异步写入 CSV 日志，Reset 后自动开始新的日志段。
• 历史曲线窗口：扫描/滚动模式、多指标显隐、预设参考线与 CSV 导出。
• 内置响度预设，并支持自定义预设及每通道选择。
• .meter 配置的保存与加载，以及全局设置持久化。
• Windows 托盘：点击最小化按钮会隐藏到托盘；左键托盘图标或右键菜单主项可在隐藏与恢复之间切换。
• 可选 OpenGL 加速，默认关闭以优先保证显卡驱动兼容性。

运行要求

• Windows 10 或 Windows 11 x64。
• JACK2 Windows 发行版已安装，并在需要采集时启动 jackd 或 qjackctl。
• 通过 qjackctl/Patchbay 将源端口连接到 JackMeterBridge:In1、JackMeterBridge:In2 等输入端口。

应用使用系统已安装的 JACK2 运行时；不需要把 libjack64.dll 复制到应用目录。未连接到 JACK 服务时，界面会显示 JACK OFFLINE，其余界面功能仍可使用。

使用方法

1. 启动 JACK 服务，例如通过 qjackctl 启动服务器。
2. 运行 Jack Meter Bridge.exe。
3. 在 qjackctl/Patchbay 中，将音频源连接到应用的 In1、In2 等端口。
4. 通过顶部的 Add channel、Remove channel 和分组按钮管理通道；双击通道名可重命名。
5. 在通道卡片中使用 Reset 清除该通道的累计响度与历史数据；顶部 Reset all 会重置所有通道。
6. 打开通道 Record 后，日志会写入 Settings 配置的根目录，目录结构为 <日志目录>/<通道名>/。
7. 右键通道卡片可打开历史曲线窗口并导出 CSV。

Settings

Settings 对话框可配置：

• 最大通道数、默认历史窗口。
• 静音自动重置的阈值与持续时间。
• Peak 保持时间。
• CSV 日志目录与写入间隔。
• 新通道默认响度标准及默认显示的指标。
• Enable OpenGL acceleration：默认关闭。开启后会在主窗口建立后尝试启用 GPU 加速；如遇显卡驱动兼容性问题，请关闭此选项并重启应用。

全局设置保存于 EXE 同目录的 config.json。通道、分组与显示状态可另存为 .meter 文件。

构建

仓库已包含 JUCE 与 JACK2 依赖源码/导入库。构建脚本使用 Windows x64 的 MSVC、CMake 和 Ninja。

Debug：

cmd /c scripts\configure-ninja.cmd
cmd /c scripts\build-ninja.cmd

Release：

cmd /c scripts\configure-release-ninja.cmd
cmd /c scripts\build-release-ninja.cmd

Release 程序输出路径：

build\ninja-x64-Release\JackMeterBridge_artefacts\Release\Jack Meter Bridge.exe

测试

构建完成后，可直接运行以下算法单元测试：

build\ninja-x64-Debug\bin\MeterEngineTests.exe
build\ninja-x64-Debug\bin\SilenceDetectorTests.exe

真实 JACK 路由、托盘行为与 OpenGL 兼容性需要在目标 Windows 音频环境中手动确认。