srt-fuzzy-sync

English | 中文说明

This is a simple subtitle sync tool, use a reference srt file to make another one sync correctly with the audio. srt-fuzzy-sync 是一个简单的同步srt字幕的工具, 通过指定一个与音轨匹配的参考字幕文件, 来将另一个未同步的字幕进行匹配, 时间轴修正, 使得其可以与音轨正确对齐.

Common use case:

• two subtitles in the same language (srtA in language A , srtB in language A )
• or use a synced single language subtitle to make another dual language subtitle sync correctly. ( srtA in language A , srtB in language A&B)

It uses fuzzy sub string matching for find the match, and shift the subtitles.

Usage

Ensure you have python3 installed. tested on python 3.9, but all python>=3.8 should works fine.

# use pip 
pip install srt-fuzzy-sync

then specify the reference srt file , target srt file to be sync, and the output file in cli args.

srt-fuzzy-sync run-sync -r mysub/reference.srt -t mysub/not-synced.srt -o mysub/ouput.srt

# manual available via `--help`
srt-fuzzy-sync run-sync --help
#Usage: srt-fuzzy-sync run-sync [OPTIONS]
#
#Options:
#  -r, --reference_sub TEXT   reference srt sub file path  [required]
#  -t, --to_be_sync_sub TEXT  target to be syned srt sub file path  [required]
#  -o, --output_path TEXT     output srt file path  [required]
#  --help                     Show this message and exit.

then you can get the correctly synced srt file, now enjoy your shows!

More information

Performance:

For a 25-min episode, syncing two subtitles takes 0.3s on my M1 Mac mini.

Sync subtitles in batch:
In case you need this, here is a sample shell command you can sync many subtitles once in a time.

(reference srt file name like "S01E01.eng.srt", target srt files "S01E01.zho.srt", output srt files "S01E01.new.srt")

find ../Season\ 28/ -type f -name "*.zho.srt" -exec bash -c 'f="{}"; srt-fuzzy-sync run-sync -r "${f%.zho.srt}.eng.srt" -t "$f" -o "${f%.zho.srt}.new.srt" ' \;

License

MIT

srt-fuzzy-sync 中文说明

srt-fuzzy-sync 是一个简单的同步srt字幕的工具, 通过指定一个与音轨匹配的参考字幕文件, 来将另一个未同步的字幕进行匹配, 时间轴修正, 使得其可以与音轨正确对齐.

使用场景说明:

• 将两个同样语言的字幕文件进行对齐
• 用一个正确对齐的A语言字幕, 来将另一个A和B的双语字幕进行同步. 如通过影片官方或内嵌的英文字幕, 来将另一个下载来的双语字幕进行对齐同步

本工具使用模糊子字符串匹配算法来寻找两个字幕文件之间的关联匹配的部分, 然后计算时间偏移量, 来修正目标字幕的时间轴

使用说明

确保已经安装了 Python3 的环境. 本机Python 3.9 测试没问题. 理论上来说Python>=3.8都可以正常运行

# use pip 
pip install srt-fuzzy-sync

# 如果身在墙内安装速度太慢, 可以修改 pypi 镜像源. 
# for pip
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

然后通过命令行调用, 指定要参考的srt字幕文件, 要同步的srt字幕文件, 输出文件位置即可

srt-fuzzy-sync run-sync -r mysub/reference.srt -t mysub/not-synced.srt -o mysub/ouput.srt

# 获取帮助可使用 `--help`
srt-fuzzy-sync run-sync --help
#Usage: srt-fuzzy-sync run-sync [OPTIONS]
#
#Options:
#  -r, --reference_sub TEXT   reference srt sub file path  [required]  , 即参考字幕
#  -t, --to_be_sync_sub TEXT  target to be syned srt sub file path  [required], 即要同步的字幕
#  -o, --output_path TEXT     output srt file path  [required], 保存文件的位置
#  --help                     Show this message and exit.

更多信息

性能

本地测试中, 对一个25分钟长度的剧集的两个字幕进行对齐同步, 在我的M1 Mac Mini 耗时0.3s

批量处理字幕

以下是示例shell (参考字幕为"S01E01.eng.srt", 要处理的字幕为 "S01E01.zho.srt", 保存位置 "S01E01.new.srt")

find ../Season\ 28/ -type f -name "*.zho.srt" -exec bash -c 'f="{}"; srt-fuzzy-sync run-sync -r "${f%.zho.srt}.eng.srt" -t "$f" -o "${f%.zho.srt}.new.srt" ' \;

# 转换完成后, 可以删除不需要的字幕文件, 然后使用 rename 命令批量修改文件后缀为zh
rename 's/\.new\.srt/\.zh.srt/' ./*.srt

为了更方便使用和维护, 也可以使用更简洁的shell脚本. 示例如下:

#!/bin/bash

# 设置输入目录
input_dir="/data/media/Loki_S01"

# 遍历目录中的所有 MKV 文件, 如果要处理的是mp4 文件, 把下面所有的mkv 替换为mp4
for mkv_file in "$input_dir"/*.mkv; do
    # 获取文件名（不带扩展名）
    base_name=$(basename "$mkv_file" .mkv)

    # 定义参考字幕和待修正字幕的路径
   
    # 对于一个视频文件 video.mkv
    # 这里假设所有的参考字幕格式为video_ref.srt
    ref_subtitle="$input_dir/${base_name}_ref.srt" 
    # 假设待对齐的文件为 video_nosync.srt
    nosync_subtitle="$input_dir/${base_name}_nosync.srt"
    # 设定新文件为 video_new.srt
    output_subtitle="$input_dir/${base_name}_new.srt"

    # 检查参考字幕和待修正字幕是否存在
    if [[ -f "$ref_subtitle" && -f "$nosync_subtitle" ]]; then
        # 调用第三方工具修正字幕
        srt-fuzzy-sync run-sync -r "$ref_subtitle" -t "$nosync_subtitle" -o "$output_subtitle"
        echo "Processed: $mkv_file -> $output_subtitle"
    else
        echo "Missing subtitles for: $mkv_file"
    fi
done

使用说明 将上面的脚本保存为 fix_subtitles.sh。 确保脚本具有可执行权限，可以通过以下命令设置： chmod +x fix_subtitles.sh 运行脚本： bash ./fix_subtitles.sh

许可

MIT