如何使用Sushi快速同步字幕？3分钟掌握核心命令与实用示例

【免费下载链接】SushiAutomatic subtitle shifter based on audio项目地址: https://gitcode.com/gh_mirrors/sus/Sushi

Sushi是一款基于音频分析的自动字幕同步工具，能帮助用户快速解决不同版本视频间的字幕错位问题。无论是TV与蓝光版本的视频差异，还是PAL与NTSC制式的帧率不同，Sushi都能通过音频特征比对，自动计算并调整字幕时间轴，让字幕与视频完美匹配。

📋 核心功能与适用场景

Sushi的核心优势在于无需手动调整时间码，通过分析音频波形特征实现精准同步。常见使用场景包括：

• 修复下载字幕与本地视频的时间差
• 适配不同版本视频（如导演剪辑版与剧场版）的字幕
• 解决帧率转换导致的字幕偏移问题

🔧 快速安装指南

环境准备

确保系统已安装Python 3.6+及依赖库：

git clone https://gitcode.com/gh_mirrors/sus/Sushi cd Sushi pip install -r requirements.txt

⚙️ 核心命令解析

Sushi的基础使用语法简洁直观，核心命令结构如下：

python sushi.py --src <源视频路径> --dst <目标视频路径> --sub <待同步字幕路径>

必选参数说明

高级参数调节

• --sample-rate：音频采样率（默认12000Hz），可根据视频质量调整
• --sample-type：采样数据类型（可选uint8/float32），影响分析精度

📝 实用示例教程

基础同步示例

将字幕同步到不同版本的视频文件：

python sushi.py --src "GameOfThrones.S01E01.BD.mkv" \ --dst "GameOfThrones.S01E01.TV.mp4" \ --sub "got_s01e01_subtitles.srt"

执行后将生成target.sushi.srt文件，即为同步后的字幕。

处理特殊情况

当视频存在显著音频差异时（如不同语言配音），可通过调整采样参数提高准确率：

python sushi.py --src "movie_eng.mkv" \ --dst "movie_jpn.mkv" \ --sub "subtitles.ass" \ --sample-rate 16000 \ --sample-type float32

🛠️ 常见问题解决

同步结果不准确？

1. 确保源视频与目标视频内容一致（避免不同集数或版本）
2. 尝试提高--sample-rate参数值（如16000或24000）
3. 检查字幕文件是否完整，无损坏或乱码

支持哪些格式？

• 视频格式：MP4、MKV、AVI等主流容器
• 字幕格式：SRT、ASS、SSA（输出格式与输入保持一致）

📚 更多资源

• 配置文件示例：tests.example.json
• 测试脚本参考：regression-tests.py
• 音频处理模块：wav.py

通过以上步骤，您已掌握Sushi的核心使用方法。无论是日常观影还是字幕制作，这款工具都能帮您高效解决字幕同步难题，让观影体验更加流畅！

【免费下载链接】SushiAutomatic subtitle shifter based on audio项目地址: https://gitcode.com/gh_mirrors/sus/Sushi