|
|
FFsubsync GUI —— 批量视频字幕同步工具(附环境配置教程)
一句话:把视频和字幕丢进去,软件自动把字幕时间轴对齐到视频。支持批量、带图形界面,比命令行省心。
一、这是什么
本工具是 FFsubsync(是在github发现的项目,命令行字幕同步神器)的图形界面(GUI)封装。- FFsubsync 本体:通过对齐「视频音轨」和「字幕文本」的时间,自动修正字幕偏移、错轴等问题。
- 本 GUI:给它一个视频 + 一个字幕,点一下就同步;支持一次加一堆任务批量跑、实时看进度、管理任务列表。
- 最近整理影音库,发现好多字幕与视频不同步, 本来想找现成的使用,找到一个还停更了 ,所以就只能自己做一个了,只是做了图形壳,用的核心还是github原作者的FFsubsync ,如果侵权,可联系我删帖
图1添加任务

图2环境检测

图3完成同步

二、主要功能- 批量任务:可一次添加多个「视频+字幕」任务,排队自动同步
- 任务列表管理:添加 / 编辑 / 复制 / 删除 / 上移下移(右键菜单),完成状态自动保存,重启不丢
- 多种语音检测模式(VAD):webrtc / fused / silero / subs_then_webrtc,默认 webrtc
- 实时进度:进度条显示「当前正在处理的文件名 + 百分比」
- 参数优先级清晰:每个任务可单独设参数;没单独设的,自动继承全局参数(任务级 > 全局级)
- 即时停止:点「停止」立即中止,不用干等
- 窗口记忆:自动记住窗口大小和位置,下次打开不用重新调整
- 环境监测:一键检测 FFsubsync / FFmpeg / PyTorch / Python 是否齐全,点组件名可看详细安装说明
- Torch 检测:单独检测 PyTorch 可用性(含版本、CUDA、关键模块),同样可点开看说明
三、下载- 主程序:FFsubsync-gui.exe(已用 PyInstaller 打包,GUI 自身的运行环境已内置,打开界面不需要装 Python)
下载地址: 批量字幕同步工具v25.txt (114 Bytes, 下载次数: 71) 有两个版本(单文件exe版本 和 绿色解压版本)随便哪个都能用 .
重要前提(请看第四节):exe 只打包了界面,真正干活的 ffsubsync 需要你自己的电脑上有 Python 环境。下面有完整安装步骤。 四、使用前必看:环境要求(最重要!)
你要用的模式 |
需要装的东西 |
webrtc(默认,推荐大多数人) |
Python + FFsubsync + webrtcvad + FFmpeg |
fused / silero / subs_then_webrtc |
在上面基础上,额外需要 PyTorch (torch + torchaudio) |
- FFmpeg:ffsubsync 读取音轨要用,所有模式都需要。
- PyTorch:只服务于 fused/silero 这类需要「语音活动检测模型」的模式;webrtc 模式完全用不到,可跳过。
- 不装会怎样:打开软件点「🌐 环境监测」会看到缺的项标红,同步无法执行。按下面的步骤装好即可。
五、环境安装步骤(一步一步来,照抄命令即可)第 1 步:安装 Python(务必勾选 Add to PATH)- 安装时一定勾选「Add Python to PATH」,否则后面命令找不到 python
- 验证:打开命令提示符输入 python --version,能显示版本号就对了
第 2 步:安装 FFsubsync(核心,必须)
管理员身份打开命令提示符,执行:
[Asm] [color=rgb(51, 102, 153) !important]纯文本查看 [color=rgb(51, 102, 153) !important]复制代码
[backcolor=rgb(27, 36, 38) !important][color=rgb(255, 255, 255) !important][color=#ffffff !important] ?
webrtc 模式还需要语音检测库:
[Asm] [color=rgb(51, 102, 153) !important]纯文本查看 [color=rgb(51, 102, 153) !important]复制代码
[backcolor=rgb(27, 36, 38) !important][color=rgb(255, 255, 255) !important][color=#ffffff !important] ?
- 验证:ffs --help 应显示帮助信息(说明装好了)
第 3 步:安装 FFmpeg(必须)- 解压后,把里面的 bin/ffmpeg.exe 复制到本程序 FFsubsync-gui.exe 所在目录;或者把 bin 目录加入系统 PATH
- 验证:命令提示符输入 ffmpeg -version
第 4 步(可选):安装 PyTorch —— 仅当你要用 fused / silero 模式
[Asm] [color=rgb(51, 102, 153) !important]纯文本查看 [color=rgb(51, 102, 153) !important]复制代码
[backcolor=rgb(27, 36, 38) !important][color=rgb(255, 255, 255) !important][color=#ffffff !important] ?
1
| pip install torch torchaudio
|
- CPU 版就够用(字幕同步很轻量,CPU 完全能跑,GPU 版只在超大文件上有提速)
- silero 语音模型首次运行会自动下载(需联网)
嫌一步步装麻烦?软件里的「环境监测」对话框,每一项缺失的组件名都是蓝色可点击的,点开就是完整的下载地址 + 安装命令 + 步骤,照着点就行。
六、怎么用- 在「全局参数」里选好 VAD 模式等(新建任务会继承这些设置)
- 点「添加」,填:视频文件、字幕文件、输出目录(留空则用视频同目录)
- 可继续加多个任务;或右键任务列表做编辑 / 复制 / 删除 / 上移下移
- 点「开始同步」,进度条会显示「同步: 文件名 XX%」
- 同步完成后,输出字幕出现在你指定的目录(文件名带时间戳)
七、VAD 模式怎么选
模式 |
需要 torch |
说明 |
适合 |
webrtc |
不需要 |
轻量、速度快、无需额外模型 |
大多数人首选 |
fused |
需要 |
融合多种检测,效果通常更好 |
对对齐精度要求高 |
silero |
需要 |
基于 silero-vad 模型 |
同上 |
subs_then_webrtc |
不需要 |
先用字幕再用 webrtc 兜底 |
特殊场景 |
不确定就先选 webrtc,它最省事、什么都不用额外装。
八、环境监测 / Torch 检测说明- 环境监测:检测 FFsubsync / FFmpeg / PyTorch / Python / PyQt6 是否齐全。
- 缺失项(红色)的组件名是蓝色下划线,点一下会弹出详细说明:这是什么、何时需要、下载链接、可复制的安装命令、当前状态。
- 检测Torch:单独看 PyTorch 情况(版本、CUDA、关键模块),「检测结果」一行同样可点击看安装说明。
- 这两项都是为了帮兄弟们自查环境,缺啥点啥,不用到处问。
九、常见问题 FAQ
Q1:环境监测里「CUDA 可用: False」是什么?
A:表示你的电脑没有 NVIDIA 显卡 / 没装 CUDA 驱动,PyTorch 只能跑 CPU 模式。完全正常、不影响使用,VAD 检测照常工作。有独显的话通常是装了 CPU 版 torch,想用 GPU 加速才需要重装对应 CUDA 版本的 torch(见第四节第 4 步)。
Q2:打开软件要不要装 Python?
A:打开界面不用(exe 自带 GUI 运行环境)。但真正同步字幕需要你电脑上有 Python + ffsubsync(第四节)。本工具目前是「界面打包、核心外调」的架构。
Q3:进度条 XX% 后不动了 / 卡住?
A:ffsubsync 处理长视频时可能阶段性无输出,属正常。点「停止」会立即中止。若长时间无进展可看日志区有没有报错。
Q4:输出字幕文件名怎么带时间戳?
A:这是默认行为,输出文件名形如 原名.20260709_231500.srt,方便区分多次同步结果。
Q5:任务列表右键没反应 / 想调整顺序?
A:右键任务行有「添加 / 编辑 / 复制 / 删除 / 上移 / 下移」。运行中部分危险操作会临时禁用,停止后即可用。
Q6:能不能做成完全不用装 Python 的版本?
A:可以,但需要把 Python 运行时和 ffsubsync 一起冻结进 exe(做成 webrtc 专用轻量包)。当前版本未包含,需要的可后续反馈。 十、版本- v25:环境监测 / Torch 检测均支持「点击组件名看安装说明」;缺失项蓝色可点击;界面细节优化。
十一、反馈与免责- 使用中有问题,先看「环境监测」缺什么,按说明装上基本都能解决。
- 本工具仅封装 FFsubsync,同步算法归原项目所有;字幕版权请自行负责。
打完收工!!!
|
|