Skip to content

RhythmAlign v1.0.1

Choose a tag to compare

View all tags
@Daozhu1007 Daozhu1007 released this 23 May 17:42
· 20 commits to main since this release
v1.0.1
7241ac6

音游手元音频自动对齐工具 | 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

Assets 4
Loading