中文 · English

oldtoneFix 是面向朗读、旁白和有声资料的老录音批量降噪工具。它压低持续的宽带底噪、白噪声和电流嘶声，同时尽量保留口齿清晰度与原始音色。

功能亮点

• 人声优先：RNNoise 与 FFT 降噪组合，避免只追求“安静”而吞掉字音。
• 批量处理：支持单个音频文件或递归处理整个目录。
• 安全输出：使用临时文件处理，成功后再原子替换目标文件。
• 结构保留：保留元数据、文件扩展名和输入目录的相对结构。
• 参数可调：可独立控制高通、RNNoise、FFT 噪声模型和高频修整。

环境要求

• Python 3.10+
• 已加入 PATH 的 FFmpeg
• 仓库内的 RNNoise 模型：models/cb.rnnn

浏览器界面

推荐使用本地浏览器界面：所有降噪参数都提供带默认位置、当前值、用途说明和“越小 / 越大”听感提示的滑块；批量任务会显示实时进度、完成数量和逐文件日志。

Windows：

双击 start_web.bat

macOS：

双击 start_web.command

如果 macOS 提示没有执行权限，请在项目目录运行一次 chmod +x start_web.command，然后重新双击。

也可以从终端手动启动：

python .\scripts\oldtonefix_web.py

程序会自动打开浏览器；如果不希望自动打开，可运行 python .\scripts\oldtonefix_web.py --no-open，然后访问终端中显示的本地地址。浏览器界面与命令行使用同一个 scripts/oldtonefix.py 处理链，因此仍需安装 FFmpeg，并保留 models/cb.rnnn。

快速开始

完整命令形式（[] 表示可选）：

python .\scripts\oldtonefix.py -i <输入路径> [-o <输出目录>] [-k]
  [--highpass-hz <Hz>] [--rnnoise-mix <MIX>] [--afftdn-nr <dB>] [--afftdn-nf <dB>]
  [--afftdn-nt white|vinyl|shellac] [--afftdn-tn | --no-afftdn-tn]
  [--treble-gain <dB>] [--treble-hz <Hz>] [--treble-width <W>]

处理单个文件：

python .\scripts\oldtonefix.py -i "samples\recording.mp3"

递归处理目录并指定输出目录：

python .\scripts\oldtonefix.py -i "samples" -o "samples\out"

保留已经存在的输出文件：

python .\scripts\oldtonefix.py -i "samples" --output "samples\out" --keep-existing

调整降噪强度：

python .\scripts\oldtonefix.py -i "samples\recording.mp3" --rnnoise-mix 0.7 --afftdn-nr 12 --treble-gain -3

查看完整命令行帮助：

python .\scripts\oldtonefix.py --help

输出行为

• 默认在源文件旁生成 *_processed，例如 old recording_processed.mp3。
• 指定与源目录不同的 -o / --output 后，输出会保留原文件名；目录批处理同时保留相对路径。
• 如果指定的输出位置会与源文件相同，程序仍会自动增加 _processed，不会覆盖源文件。
• 默认覆盖已经存在的目标文件。
• 使用 -k / --keep-existing 可保留并跳过已经存在的输出。
• .mp3 使用 libmp3lame -q:a 2，.wav 使用 24-bit PCM，.flac 保持无损编码。

处理链路

输入音频 → 高通滤波 → RNNoise → FFT 降噪 → 高频修整 → 原格式输出

阶段	作用
高通滤波	去除直流偏移和极低频隆隆声
RNNoise	作为主要降噪器压低连续底噪
afftdn	进一步处理 RNNoise 后残留的嘶声
treble	柔化刺耳高频，或按需恢复空气感

命令行参数

参数	是否可选	说明
-i / --input	必填	输入音频文件或目录
-o / --output	可选	输出目录；不同目录保留原文件名，留空则在源文件旁生成 *_processed
-k / --keep-existing	可选	保留并跳过已经存在的输出
-h / --help	可选	显示英文命令行帮助

调优参数

不传调优参数时使用经过试听验证的默认预设。

参数	是否可选	范围	默认	作用	越小	越大
--highpass-hz	可选	1~500	28	切除极低频隆隆声	低频更厚	更干净、更薄
--rnnoise-mix	可选	-1~1	0.78	RNNoise 干湿比，主要降噪强度	更保字、底噪更多	更干净、易吞字
--afftdn-nr	可选	0.01~97	14	FFT 再压低残留嘶声	细节与嘶声更多	嘶声更少、易发闷
--afftdn-nf	可选	-80~-20	-50	FFT 假定噪声地板，单位 dB	更保守	更激进
--afftdn-nt	可选	white / vinyl / shellac	white	噪声频谱模型	—	white 偏嘶声；vinyl/shellac 偏低频底噪
--afftdn-tn / --no-afftdn-tn	可选	on/off	on	是否随时间更新噪声估计	—	开启更适应变化；关闭更固定
--treble-gain	可选	-20~20	-2.5	高频搁架增益，单位 dB	更暗、较少刺耳	更亮、更易发尖
--treble-hz	可选	1000~16000	7000	高频搁架中心频率	影响范围更宽	更偏超高频
--treble-width	可选	0.01~5	0.6	高频搁架过渡宽度	更陡、更局部	更缓、更宽

测试

python -m unittest discover -s tests -v

许可证

本项目采用 MIT License。