Releases: Daozhu1007/RhythmAlign
Releases · Daozhu1007/RhythmAlign
Release list
RhythmAlign v1.1.2
RhythmAlign v1.1.2
这版主要整理 UI 主题适配、拖拽导入和 Windows 桌面集成，重点解决浅色 Windows 下看不清、深色模式初始渲染、任务栏图标偶发默认图标等体验问题。
更新亮点
- 新增深浅色主题支持：可在设置页选择浅色、深色，或跟随 Windows 系统主题。
- 新增拖拽导入：可直接把视频和音频拖入手元对齐或纯分析页面。
- 优化浅色/深色启动渲染：修复标题、设置页、关于页、Terminal 日志区在不同主题下的对比度和初始显示问题。
- 优化 Windows 任务栏图标稳定性：统一安装版 AppUserModelID 与快捷方式图标，并区分安装版/便携版身份，减少默认图标回退。
- 优化 README：把历史 What's New 移到 Release Notes，README 聚焦当前下载、亮点和使用说明。
- 保留 v1.1.1 的启动/手动检查更新、诊断信息复制和打包稳定性能力。
下载建议
- 推荐普通用户下载：
RhythmAlign_v1.1.2_Setup.exe - 需要免安装时下载：
RhythmAlign-v1.1.2-Portable.zip
SHA256
RhythmAlign_v1.1.2_Setup.exe
6E4E2275FC423123595C0E3153BED6E48D5B8B43DDDA423DC6C53CDF61816532RhythmAlign-v1.1.2-Portable.zip
489D81F7BB2F383C9B10F5F63EAE10567AFDB10A1C59E4E3CA609FC0948040EB
验证
- 单元测试：
19 passed - PyInstaller / Inno Setup 打包：通过
- 打包版 exe 启动烟测：通过
- 打包版 exe 图标提取检查：通过
RhythmAlign v1.1.1
RhythmAlign v1.1.1
这版主要完善 v1.1.0 对齐引擎之后的发布体验和维护能力。
更新亮点
- 新增设置页「检查更新」：检查 GitHub 最新版本，并下载带 SHA256 校验的安装包。
- 新增启动自动检查更新：后台检查，只有发现新版时才提示。
- 新增「复制诊断信息」：一键复制版本、系统、FFmpeg、设置和最近日志，方便排查问题。
- 优化打包稳定性：打包产物包含离线更新清单和
certifiCA 证书，降低 HTTPS 检查更新失败概率。 - README 已补充 v1.1.1 说明，并保留 v1.1.0 对齐引擎升级记录。
下载建议
- 推荐普通用户下载：
RhythmAlign_v1.1.1_Setup.exe - 需要免安装时下载：
RhythmAlign-v1.1.1-Portable.zip
SHA256
RhythmAlign_v1.1.1_Setup.exe
C3F560C5D676A5455D72A5D20309C3C50241B51A3E59B88785557DE8B11B5EDERhythmAlign-v1.1.1-Portable.zip
37F3D69CB27372F99DFCED2DCAFF47ECDACD1B83ACA9BC85BD18950D00C2BF4C
验证
- 单元测试：
19 passed - 便携版启动烟测：通过
- 安装版静默安装、启动、卸载烟测：通过
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
RhythmAlign v1.0.2
音游手元音频自动对齐工具 | Auto Audio-Video Sync for Rhythm Game Hand-Cams
核心特性 | Core Features
- Chroma + Onset 两级级联算法 — 先通过 Chroma CENS 特征粗定位，再以 Onset Envelope 精细互相关。引入 Z-score 可靠性门控 (阈值 2.0)，低置信度自动降级至节奏检测策略，杜绝虚假零偏移。
- 彻底脱离 MoviePy — 全面迁移至
imageio-ffmpeg+ FFmpeg 子进程底层重构，流拷贝与重编码双路径，支持 GPU 硬件加速 (NVIDIA NVENC)。 - 无损流拷贝模式 — 默认开启 Stream Copy，直接重封装音轨，100% 保留原始画质并极速导出。
- 纯分析模式 — 仅计算音乐相对视频的同步偏移量，输出精确拖拽指南，无需渲染等待。
- 中英双语界面 — 基于 JSON 的轻量 i18n 引擎，运行时切换语言。安全降级容错，翻译键损坏时不再静默吞错。
- PyQt6 + QFluentWidgets — 现代深色主题 UI，流畅亚克力导航，高 DPI 适配。
v1.0.2 更新内容 | What's New
🐛 问题修复
- 修复导航侧边栏标题 "RhythmAlign v1.0.x" 中版本号被裁切的问题——将侧边栏展开宽度从 180px 增至 210px，确保完整显示。
- 修复 v1.0.1 发布时遗漏更新
locales/zh_CN.json、locales/en_US.json、README.md、README_zh.md四处版本号的问题，建立 10 项版本号逐条核对清单。 - 清理项目根目录残留的 Release Notes markdown 文件及已迁移至
assets/的旧图片引用。
下载 | Downloads
| 类型 | 文件名 |
|---|---|
| 安装版 (推荐) | RhythmAlign_v1.0.2_Setup.exe |
| 便携版 | RhythmAlign-v1.0.2-Portable.zip |
安装说明 | Installation
Windows 10/11 x64:
- Setup 版: 双击安装程序，按向导完成安装。自动创建桌面与开始菜单快捷方式。
- Portable 版: 解压 ZIP 到任意目录，直接运行
RhythmAlign.exe。
首次启动时如需 Microsoft Visual C++ Redistributable，请从 微软官方 下载安装。
已知限制 | Known Issues
- 仅支持 Windows x64 平台。
- GPU 加速仅支持 NVIDIA 显卡 (NVENC)。
- 当视频内录音频与纯净音乐差异过大时，自动对齐可能失败，请使用手动微调。
- 超长音频 (>1 小时) 存在 OOM (内存溢出) 风险，此问题已在知悉列表中，将在后续版本通过流式特征提取或分段对齐策略解决。
许可 | License
本软件基于 PolyForm Noncommercial 1.0.0 许可协议，仅供个人非商业使用。详见 LICENSE。
Limitime — May 2026
RhythmAlign v1.0.1
音游手元音频自动对齐工具 | Auto Audio-Video Sync for Rhythm Game Hand-Cams
核心特性 | Core Features
- Chroma + Onset 两级级联算法 — 先通过 Chroma CENS 特征粗定位，再以 Onset Envelope 精细互相关。引入 Z-score 可靠性门控 (阈值 2.0)，低置信度自动降级至节奏检测策略，杜绝虚假零偏移。
- 彻底脱离 MoviePy — 全面迁移至
imageio-ffmpeg+ FFmpeg 子进程底层重构，流拷贝与重编码双路径，支持 GPU 硬件加速 (NVIDIA NVENC)。 - 无损流拷贝模式 — 默认开启 Stream Copy，直接重封装音轨，100% 保留原始画质并极速导出。
- 纯分析模式 — 仅计算音乐相对视频的同步偏移量，输出精确拖拽指南，无需渲染等待。
- 中英双语界面 — 基于 JSON 的轻量 i18n 引擎，运行时切换语言。新增安全降级容错，翻译键损坏时不再静默吞错。
- PyQt6 + QFluentWidgets — 现代深色主题 UI，流畅亚克力导航，高 DPI 适配。
v1.0.1 更新内容 | What's New
🚀 优化与重构
- 音频解析正则放宽：
_parse_duration_hms现已兼容非标准 FFmpeg 容器返回的整数秒格式，避免因 duration 解析失败导致对齐流程中断。 - FFmpeg 滤镜图精简：当音视频偏移量可忽略 (<1ms) 时，自动跳过
adelay/atrim滤镜插入，减少不必要的滤镜图复杂度与 CPU 开销。 - Worker 线程模板方法重构：抽取
BaseMediaWorker(QThread)基类，统一管理信号发射与错误处理逻辑，消除 Sync/Analyze 双 Worker 中的重复样板代码。 - Chroma 交叉相关调用统一：
diagnose_offset.py中手写的 chroma 互相关逻辑已替换为_align_chroma标准调用，确保诊断工具与主对齐引擎行为一致。 - I18n 降级容错机制：
I18nManager.tr()在格式化字符串异常时不再静默吞错，改为输出至 stderr 并返回安全降级文本。 - 移动端视频兼容性加固：针对 iPhone 录制的 MOV/HEVC/VFR 视频，增加
+genpts/-avoid_negative_ts make_zero时间戳修复、Dolby Vision DOVI 元数据剥离、无声音轨 probe 保护。 - 配置清理：移除废弃的
config/config.json，统一由项目根目录config.json接管。
🐛 问题修复
- 修复低质量麦克风录音在 Chroma CENS 策略下 Z-score 低于噪声阈值时，
argmax错误落在 lag=0 导致返回虚假偏移量 0.0000s 的问题。 - 修复
QLineEdit.text()与placeholderText的逻辑误判，改为os.path.isfile()硬检查。 - 修复
OptionsSettingCard中使用不存在的comboBox信号，替换为optionChanged。 - 修复并发执行时
int(time.time())临时文件名碰撞风险，改用uuid.uuid4().hex。 - 修复
librosa.load()未指定mono=True导致双声道重复切片，浪费约 50% 特征提取内存。 - 修复
errors='ignore'导致的静默 Unicode 损坏，统一替换为errors='replace'。
下载 | Downloads
| 类型 | 文件名 |
|---|---|
| 安装版 (推荐) | RhythmAlign_v1.0.1_Setup.exe |
| 便携版 | RhythmAlign-v1.0.1-Portable.zip |
安装说明 | Installation
Windows 10/11 x64:
- Setup 版: 双击安装程序，按向导完成安装。自动创建桌面与开始菜单快捷方式。
- Portable 版: 解压 ZIP 到任意目录，直接运行
RhythmAlign.exe。
首次启动时如需 Microsoft Visual C++ Redistributable，请从 微软官方 下载安装。
已知限制 | Known Issues
- 仅支持 Windows x64 平台。
- GPU 加速仅支持 NVIDIA 显卡 (NVENC)。
- 当视频内录音频与纯净音乐差异过大时，自动对齐可能失败，请使用手动微调。
- 超长音频 (>1 小时) 存在 OOM (内存溢出) 风险，此问题已在知悉列表中，将在后续版本通过流式特征提取或分段对齐策略解决。
许可 | License
本软件基于 PolyForm Noncommercial 1.0.0 许可协议，仅供个人非商业使用。详见 LICENSE。
Limitime — May 2026
RhythmAlign v1.0.0 Preview
音游手元音频自动对齐工具 | Auto Audio-Video Sync for Rhythm Game Hand-Cams
核心特性 | Core Features
- Chroma + Onset 两级级联算法 — 先通过 Chroma 特征粗定位，再以 Onset 包络精细互相关，兼顾大偏移搜索与子样本级精度。
- 彻底脱离 MoviePy — 全面迁移至
imageio-ffmpeg+ FFmpeg 子进程底层重构，流拷贝与重编码双路径，支持 GPU 硬件加速 (NVIDIA NVENC)。 - 无损流拷贝模式 — 默认开启 Stream Copy，直接重封装音轨，100% 保留原始画质并极速导出。
- 纯分析模式 — 仅计算音乐相对视频的同步偏移量，输出精确拖拽指南，无需渲染等待。
- 中英双语界面 — 基于 JSON 的轻量 i18n 引擎，运行时切换语言 (需重启生效)。
- PyQt6 + QFluentWidgets — 现代深色主题 UI，流畅亚克力导航，高 DPI 适配。
技术架构 | Tech Stack
| 模块 | 技术 |
|---|---|
| UI 框架 | PyQt6 + QFluentWidgets |
| 音频分析 | librosa (Chroma + Onset + F0 Contour) |
| 互相关计算 | scipy.signal.correlate |
| 视频处理 | imageio-ffmpeg + FFmpeg CLI |
| 打包分发 | PyInstaller + Inno Setup |
| 国际化 | 自研 JSON i18n 引擎 |
下载 | Downloads
| 类型 | 文件名 |
|---|---|
| 安装版 (推荐) | RhythmAlign-v1.0.0-Preview-Setup.exe |
| 便携版 | RhythmAlign-v1.0.0-Preview-Portable.zip |
安装说明 | Installation
Windows 10/11 x64:
- Setup 版: 双击安装程序，按向导完成安装。自动创建桌面与开始菜单快捷方式。
- Portable 版: 解压 ZIP 到任意目录，直接运行
RhythmAlign.exe。
首次启动时如需 Microsoft Visual C++ Redistributable，请从 微软官方 下载安装。
已知限制 | Known Issues
- 仅支持 Windows x64 平台。
- GPU 加速仅支持 NVIDIA 显卡 (NVENC)。
- 当视频内录音频与纯净音乐差异过大时，自动对齐可能失败，请使用手动微调。
许可 | License
本软件为免费开源社区工具，仅供个人学习使用。详见 LICENSE。
Limitime — May 2026