ffsubsync

ffsubsync

自动对齐字幕和视频的开源解决方案

FFsubsync是一个开源的自动字幕同步工具,适用于各种语言的字幕。它通过分析视频音频和字幕文件,利用快速傅里叶变换算法找出最佳匹配点,从而解决字幕与视频不同步的问题。该工具支持多种文件格式,处理速度快,通常只需20-30秒即可完成同步。FFsubsync特别适用于处理从不同来源获取的视频和字幕文件,如下载的电影、电视剧或在线视频平台的内容。它可以有效解决由于帧率差异、剪辑不一致或时间码错误导致的字幕同步问题,为用户提供更好的观看体验。FFsubsync为提升视频观看体验提供了一个简单有效的解决方案,特别适合需要处理大量视频字幕的用户。

FFsubsync字幕同步语音活动检测音频处理开源项目Github

FFsubsync

CI 状态 支持乌克兰 使用 mypy 检查 代码风格:black 许可证:MIT Python 版本 文档状态 PyPI 版本

与语言无关的字幕与视频自动同步,使字幕与视频中的正确起始点对齐。

从这样:变成这样:

支持开发

请考虑支持乌克兰,而不是直接捐赠给这个项目。话虽如此,应一些人的要求,你现在可以使用页面顶部的 Github Sponsors 按钮或下面的 Paypal 捐赠按钮来帮助支付我的咖啡费用:

捐赠

安装

首先,确保已安装 ffmpeg。在 MacOS 上,可以这样安装:

brew install ffmpeg

(Windows 用户:确保 ffmpeg 在你的路径中,并且可以从命令行引用!)

接下来,获取软件包(兼容 Python >= 3.6):

pip install ffsubsync

如果你想冒险尝试,可以按以下方式获取最新版本:

pip install git+https://github.com/smacke/ffsubsync@latest

使用方法

ffssubsyncffsubsync 都可以作为入口点:

ffs video.mp4 -i unsynchronized.srt -o synchronized.srt

有时你可能有一个正确同步的 srt 文件,但是使用的是你不熟悉的语言,同时还有一个未同步的你母语的 srt 文件。在这种情况下,你可以直接使用正确同步的 srt 文件作为同步参考,而不是使用视频作为参考:

ffsubsync reference.srt -i unsynchronized.srt -o synchronized.srt

ffsubsync 使用文件扩展名来决定是对音频进行语音活动检测还是直接从 srt 文件中提取语音。 同步问题

如果同步失败,可以尝试以下方法:

  • 通过传递 --no-fix-framerate 参数,尝试假设视频和字幕帧率相同进行同步;
  • 尝试传递 --gss 参数,使用黄金分割搜索来找到视频和字幕帧率之间的最佳比例(默认情况下,只评估几个常见比例);
  • 如果字幕与视频的不同步超过60秒(实际上不太可能,但也有可能),可以尝试将 --max-offset-seconds 的值设置为大于默认的60;
  • 尝试使用 --vad=auditok,因为在音频质量较低的情况下,auditok有时比WebRTC的VAD效果更好。Auditok不专门检测语音,而是检测所有音频;这个特性在某些情况下可能导致同步效果不佳,但在某些情况下可能会有效。

如果同步仍然失败,可以考虑尝试以下类似工具之一:

  • sc0ty/subsync:进行语音转文字并寻找匹配的词素
  • kaegi/alass:基于Rust的字幕同步器,使用复杂的动态规划算法
  • tympanix/subsync:基于神经网络的方法,在进行语音检测时直接优化对齐
  • oseiskar/autosubsync:使用自定义频谱图和逻辑回归进行语音检测
  • pums974/srtsync:采用与ffsubsync类似的方法(WebRTC的VAD + FFT最大化信号互相关)

速度

ffsubsync 通常在20到30秒内完成,具体取决于视频的长度。最耗时的步骤实际上是提取原始音频。如果你已经有一个正确同步的"参考"srt文件(这种情况下可以跳过音频提取),ffsubsync 通常在不到一秒内运行完成。

工作原理

同步算法分为3个步骤:

  1. 将视频文件的音频流和字幕离散化为10毫秒的窗口。
  2. 对于每个10毫秒的窗口,确定该窗口是否包含语音。对于字幕来说,这很容易做到(我们只需确定每个时间窗口内是否有字幕"开启");对于音频流,使用现成的语音活动检测器(VAD),如webrtc内置的检测器。
  3. 现在我们有了两个二进制字符串:一个用于字幕,一个用于视频。尝试通过匹配0和0、1和1来对齐这些字符串。我们对这些对齐进行评分,计算方法为(与字幕1匹配的视频1的数量)-(与字幕0匹配的视频1的数量)。

第3步中得分最高的对齐方式决定了如何在时间上偏移字幕,使其与视频正确同步。由于二进制字符串相当长(对于超过一小时的视频,可能有数百万位),使用朴素的O(n^2)策略来评分所有对齐是不可接受的。相反,我们利用"评分所有对齐"是一个卷积操作的事实,可以用快速傅里叶变换(FFT)实现,将复杂度降低到O(n log n)。

局限性

在大多数情况下,视频和字幕之间的不一致发生在视频中存在但字幕中不存在的起始或结束片段,反之亦然。例如,当字幕中的电视剧回顾部分在视频中被剪掉时,就可能发生这种情况。FFsubsync在这些情况下通常表现良好,根据我的经验,这涵盖了95%以上的使用场景。处理开头和结尾片段以外的中断和分割留待未来工作(见下文)。

未来工作

除了总体稳定性和可用性改进外,一项工作旨在扩展同步算法,以处理视频中间出现但字幕中不存在的分割/中断(或反之)。开发一个稳健的解决方案需要一些时间(假设可能的话)。更多详情请参见 #10

历史

该项目的实施始于2019年HackIllinois黑客马拉松,并获得了荣誉提名(排名前5的项目,不包括获得公司特定奖项的项目)。 鸣谢

本项目的实现离不开以下库的支持:

  • ffmpeg及其Python封装ffmpeg-python,用于从视频中提取原始音频
  • 来自webrtc的VAD及其Python封装py-webrtcvad,用于语音检测
  • srt,用于处理SRT文件
  • numpy以及间接使用的FFTPACK,为基于FFT的字幕(或字幕与视频)之间的快速对齐评分算法提供支持
  • 其他优秀的Python库,如argparserichtqdm,虽与核心功能无关,但为开发者和用户提供了更好的体验。

许可证

本项目代码采用MIT许可证

编辑推荐精选

商汤小浣熊

商汤小浣熊

最强AI数据分析助手

小浣熊家族Raccoon,您的AI智能助手,致力于通过先进的人工智能技术,为用户提供高效、便捷的智能服务。无论是日常咨询还是专业问题解答,小浣熊都能以快速、准确的响应满足您的需求,让您的生活更加智能便捷。

imini AI

imini AI

像人一样思考的AI智能体

imini 是一款超级AI智能体,能根据人类指令,自主思考、自主完成、并且交付结果的AI智能体。

Keevx

Keevx

AI数字人视频创作平台

Keevx 一款开箱即用的AI数字人视频创作平台,广泛适用于电商广告、企业培训与社媒宣传,让全球企业与个人创作者无需拍摄剪辑,就能快速生成多语言、高质量的专业视频。

即梦AI

即梦AI

一站式AI创作平台

提供 AI 驱动的图片、视频生成及数字人等功能,助力创意创作

扣子-AI办公

扣子-AI办公

AI办公助手,复杂任务高效处理

AI办公助手,复杂任务高效处理。办公效率低?扣子空间AI助手支持播客生成、PPT制作、网页开发及报告写作,覆盖科研、商业、舆情等领域的专家Agent 7x24小时响应,生活工作无缝切换,提升50%效率!

TRAE编程

TRAE编程

AI辅助编程,代码自动修复

Trae是一种自适应的集成开发环境(IDE),通过自动化和多元协作改变开发流程。利用Trae,团队能够更快速、精确地编写和部署代码,从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能,是提升开发效率的理想工具。

AI工具TraeAI IDE协作生产力转型热门
蛙蛙写作

蛙蛙写作

AI小说写作助手,一站式润色、改写、扩写

蛙蛙写作—国内先进的AI写作平台,涵盖小说、学术、社交媒体等多场景。提供续写、改写、润色等功能,助力创作者高效优化写作流程。界面简洁,功能全面,适合各类写作者提升内容品质和工作效率。

AI辅助写作AI工具蛙蛙写作AI写作工具学术助手办公助手营销助手AI助手
问小白

问小白

全能AI智能助手,随时解答生活与工作的多样问题

问小白,由元石科技研发的AI智能助手,快速准确地解答各种生活和工作问题,包括但不限于搜索、规划和社交互动,帮助用户在日常生活中提高效率,轻松管理个人事务。

热门AI助手AI对话AI工具聊天机器人
Transly

Transly

实时语音翻译/同声传译工具

Transly是一个多场景的AI大语言模型驱动的同声传译、专业翻译助手,它拥有超精准的音频识别翻译能力,几乎零延迟的使用体验和支持多国语言可以让你带它走遍全球,无论你是留学生、商务人士、韩剧美剧爱好者,还是出国游玩、多国会议、跨国追星等等,都可以满足你所有需要同传的场景需求,线上线下通用,扫除语言障碍,让全世界的语言交流不再有国界。

讯飞智文

讯飞智文

一键生成PPT和Word,让学习生活更轻松

讯飞智文是一个利用 AI 技术的项目,能够帮助用户生成 PPT 以及各类文档。无论是商业领域的市场分析报告、年度目标制定,还是学生群体的职业生涯规划、实习避坑指南,亦或是活动策划、旅游攻略等内容,它都能提供支持,帮助用户精准表达,轻松呈现各种信息。

AI办公办公工具AI工具讯飞智文AI在线生成PPTAI撰写助手多语种文档生成AI自动配图热门
下拉加载更多