RhythmAlign v1.1.0
音游手元音频自动对齐工具 | Auto Audio Alignment for Rhythm Game Handcam Videos
核心特性 | Core Features
- 自动计算手元视频原声与干净音乐之间的同步偏移量。
- 默认使用视频流直拷导出，保留原画质，只重建音轨。
- 支持原视频音轨与替换音乐混音，并提供街机、移动端、桌面端音量预设。
- 支持纯分析模式，只输出偏移量，方便在其他剪辑软件中使用。
- 内置命令行诊断工具，可查看 Z-score、独立峰值比、音频强度等关键指标。
- 支持 Windows 10/11 x64，提供安装版与便携版。
v1.1.0 重大更新 | Major Changes
对齐引擎升级
- 将主对齐策略升级为 Chroma CENS 差分 + onset 轻量融合的混合算法。
- Chroma 不再直接比较静态音高纹理，而是比较音高类别随时间的变化，显著降低重复段落造成的假峰。
- onset fallback 新增独立峰值比检查，避免在多个候选峰几乎并列时盲目选择错误小节。
- 修复重复节奏谱面中容易出现的“整体慢一拍 / 错一小节”问题。
- 在巴别塔、红宙天、海底谭等真实手元素材上验证，新算法能修复旧版明显错位的案例，同时保持原本成功案例稳定。
诊断、文档与联系信息
diagnose_offset.py现在输出独立峰值比，便于识别重复节奏导致的歧义匹配。- 修复诊断脚本在找不到
ffprobe时误报异常的问题。 - 修复诊断脚本极少数
offset == 0分支里的旧变量引用问题。 - 重写中英文 README，补充 v1.1.0 算法说明、使用流程和可靠性边界。
- 关于页面 QQ 群更新为
1046879299，QQ 群按钮现在会复制群号，不再打开占位链接。
打包可靠性
- 保留隐藏 FFmpeg 子进程窗口的修复，避免 Windows 下导出时弹出命令行窗口。
- 继续使用安装包与便携版双发行形式。
- 本次发布前已验证 portable exe 与安装后 exe 均可正常启动，不再出现点击即崩的打包问题。
下载 | Downloads
| 类型 | 文件名 |
|---|---|
| 安装版（推荐） | RhythmAlign_v1.1.0_Setup.exe |
| 便携版 | RhythmAlign-v1.1.0-Portable.zip |
SHA256:
| 文件 | SHA256 |
|---|---|
RhythmAlign_v1.1.0_Setup.exe |
01DB66E4F1E3A98A705E5FFCCA4C8DA51028518AC7EB8735DFB1784996DA3D72 |
RhythmAlign-v1.1.0-Portable.zip |
0CDCB1394E96215A32F4E00796C4C4DF4FDA4BE7AEFCCBFC9B55539E5B6A8B95 |
安装说明 | Installation
Windows 10/11 x64:
- Setup 版: 下载
RhythmAlign_v1.1.0_Setup.exe，双击安装，按向导完成即可。 - Portable 版: 下载
RhythmAlign-v1.1.0-Portable.zip，解压到任意目录，直接运行RhythmAlign.exe。
首次启动如提示缺少 Microsoft Visual C++ Runtime，请从 微软官方链接 下载并安装。
发布前验证 | Verification
python -m pytest -q: 13 passed。- PyInstaller 构建成功生成
dist/RhythmAlign/RhythmAlign.exe。 - Portable 版
RhythmAlign.exe启动 12 秒未崩溃，随后由测试脚本主动结束。 - Setup 版静默安装到临时目录成功，安装后的
RhythmAlign.exe启动 12 秒未崩溃，卸载成功。
已知限制 | Known Issues
- 仅支持 Windows x64 平台。
- GPU 加速仅支持 NVIDIA NVENC。
- RhythmAlign 是固定偏移对齐工具，无法自动修复视频中途剪切、变速或长时间音频漂移。
- 如果参考音乐与视频中实际播放的音源不是同一版本，自动对齐可能失败或产生错误偏移。
- 极端噪声、敲击声压过音乐本体、或曲目本身和声/节奏高度重复时，建议先使用纯分析模式或
diagnose_offset.py复核。
许可 | License
本软件基于 PolyForm Noncommercial 1.0.0 许可协议发布，仅供个人非商业使用。详见 LICENSE。
Limitime - June 2026