Tonescope

实时对数频谱（瀑布图）+ 音阶参考线。Rust · cpal · realfft · egui，单个可执行文件。

安装

macOS 与 Linux（x86_64）用 Homebrew：

brew trust --tap soundadam/tap
brew install --cask soundadam/tap/tonescope

Windows 从 Releases 下载 zip。

• macOS：.app 只有 ad-hoc 签名、未公证。Homebrew 装的直接能打开；从 Releases 下载的 zip 首次打开会被拦下， 到「系统设置 → 隐私与安全性」里点「仍要打开」，或者自己去掉隔离属性：

  xattr -dr com.apple.quarantine <解压出来的 Tonescope.app>
  

  首次运行会请求麦克风权限。

• Linux：需要系统里有 ALSA（libasound2）；PulseAudio / PipeWire 通过 ALSA 兼容层接入。

命令行与更新

tonescope                         # 打开界面
tonescope update                  # 更新到最新版
tonescope update --check          # 只看有没有新版
tonescope update --auto on|off    # 打开或关掉自动检查
tonescope --version

Homebrew 装的升级交给 brew，从 Releases 下载的 .app 或可执行文件原地替换自己。界面每天至多查一次新版，有新版时顶栏右侧出现 Update 按钮；设置里的 Updates 一节可以关掉自动检查。怎么判断安装方式、会发哪些网络请求见 appkit。

从源码运行

cargo run --release

Linux 构建前先装 ALSA 头文件（Debian / Ubuntu：sudo apt install libasound2-dev）。

macOS 下用 cargo run 时，麦克风权限记在启动它的那个程序（Terminal / iTerm / IDE）名下。

本地打包与 CI 用同一个脚本，产物放在 dist/：

scripts/package.sh

界面为英文，只用 egui 自带字体。

发布

产物命名、Cask 与命令行照 appkit 的约定。推 v* tag（必须与 Cargo.toml 的版本一致），release workflow 构建 macOS（通用二进制 .app）、Windows（x86_64）、Linux（x86_64）三份产物发到 Releases，再用 packaging/homebrew/tonescope.rb 填好版本与 SHA-256 推到 soundadam/homebrew-tap。带 - 的预发布 tag 不更新 Cask。

site/ 是 soundadam.com/projects/tonescope 的文案与截图，站点以 Hugo module 引入；main 上 site/ 一变，site workflow 就通知站点重新发布。

现有功能

• 默认输入设备实时采集，顶栏可切换设备；多声道下混为单声道
• 流式 STFT（Hann 窗），FFT 1024–16384、hop 128–2048 可选；幅度为 dBFS（满幅正弦 ≈ 0 dB）
• 对数频率轴瀑布图：低频行在相邻 bin 间插值，高频行取区间最大值；频率范围、dB 上下限、色表（Magma / Viridis / Gray）可调；每帧只给新列着色并局部更新纹理
• 改频率范围时从保留的原始谱重映射历史，暂停后仍可缩放已有画面
• 音阶参考线：半音阶、大调、三种小调、五种调式、大/小五声、布鲁斯、全音阶；主音 12 选 1；A4 400–480 Hz 可调；主音高亮，标签按间距自动避让
• 音高跟踪（YIN，40–2000 Hz）：每列瀑布图对应一个音高，在图上画成绿色轨迹；顶栏读数为当前音名 + 音分偏差 + Hz。 基音弱于泛音时仍报基音，不跳八度。音高窗取自同一 FFT 帧的中央，FFT 越小可测最低音越高（侧栏有显示）
• 电平门限：帧 RMS 低于门限不测音高；右侧频谱上同时标出最强频率（琥珀）与音高（绿）
• 鼠标悬停：频率、最近音名与音分、该点 dB、距今时间、该列音高；可选显示 2–8 次泛音线
• 右侧实时频谱曲线，与瀑布图共用频率轴
• 空格暂停 / 继续
• 帧率默认跟显示器刷新率（侧栏显示测到的 Hz），可限 60 / 30 fps；输入电平持续低于门限时自动降帧，暂停或没有输入设备时几乎不重画
• 侧栏 Performance：帧率、每帧 CPU（着色 / DSP 分项）、DSP 占实时比例、声音到屏幕的延迟估计（设备 / 排队 / 分析窗 / 显示分项）、丢样本计数；各项悬停有说明

待做

• 打开 WAV / FLAC 文件离线分析，可拖动时间轴
• 导出当前画面 PNG、录制最近 N 秒为 WAV
• 输入电平表与削波提示
• 非十二平均律：纯律、五度相生律、自定义 cents 表
• 可选 CQT / 重分配谱，提升低频分辨率

许可证

MIT 或 Apache-2.0，任选其一。