+1
Daily
9,733
stars
988
forks
57
watchers
68
prs
372
issues
5
releases
README
简体中文 | English
项目简介
!License
!python version
!support os
Video-subtitle-extractor (VSE) 是一款将视频中的硬字幕提取为外挂字幕文件(srt格式)的软件
主要实现了以下功能:
- 提取视频中的关键帧
- 检测视频帧中文本的所在位置
- 识别视频帧中文本的内容
- 过滤非字幕区域的文本
- 去除水印、台标文本、原视频硬字幕,可配合:video-subtitle-remover (VSR)
- 去除重复字幕行,生成srt字幕文件/txt文本文件
- 支持视频字幕批量提取
- 多语言:支持简体中文(中英双语)、繁体中文、英文、日语、韩语、越南语、阿拉伯语、法语、德语、俄语、西班牙语、葡萄牙语、意大利语等87种语言的字幕提取
- 多模式:
- 快速:(推荐)使用轻量模型,快速提取字幕,可能丢少量字幕、存在少量错别字
- 自动:(推荐)自动判断模型,CPU下使用轻量模型;GPU下使用精准模型,提取字幕速度较慢,可能丢少量字幕、几乎不存在错别字
- 精准:(不推荐)使用精准模型,GPU下逐帧检测,不丢字幕,几乎不存在错别字,但速度非常慢
请优先使用快速/自动模式,如果前两种模式存在较多丢字幕轴情况时,再使用精准模式
项目特色:
- 采用本地进行OCR识别,无需设置调用任何API,不需要接入百度、阿里等在线OCR服务即可本地完成文本识别
- 支持GPU加速,GPU加速后可以获得更高的准确率与更快的提取速度
使用说明:
- 有使用问题请加群讨论,QQ群:210150985(已满)、806152575(已满)、816881808(已满)、295894827
- 点击【打开】后选择视频文件,调整字幕区域,点击【运行】
- 单文件提取:打开文件的时候选择单个视频
- 批量提取:打开文件的时候选择多个视频,确保每个视频的分辨率、字幕区域保持一致
- 去除水印文本/替换特定文本:
如果视频中出现特定的文本需要删除,或者特定的文本需要替换,可以编辑 backend/configs/typoMap.json文件,加入你要替换或去除的内容
json
{
"l'm": "I'm",
"l just": "I just",
"Let'sqo": "Let's go",
"Iife": "life",
"威筋": "威胁",
"性感荷官在线发牌": ""
}
这样就可以把文本中出现的所有“威筋”替换为“威胁”,所有的“性感荷官在线发牌”文本删除
- 视频以及程序路径请不要带中文和空格,否则可能出现未知错误!!!
如:以下存放视频和代码的路径都不行
D:\下载\vse\运行程序.exe(路径含中文)
E:\study\kaoyan\sanshang youya.mp4 (路径含空格)
- 直接下载压缩包解压运行,如果不能运行再按照下面的教程,尝试源码安装conda环境运行
下载地址: Release
有任何改进意见请在ISSUES和DISCUSSION中提出
NVIDIA官方提供了各GPU型号的计算能力列表,您可以参考链接: CUDA GPUs 查看你的GPU适合哪个CUDA版本
NVIDIA 50系显卡需要使用cuda12.8.0及以上版本, 但Paddle3.3.1目前仍未支持,所以建议使用Directml通用版本
识别模式选择说明:
| 模式名称 | GPU | OCR模型尺寸 | 字幕检测引擎 | 备注 |
|---------------|-----|---------|------|------|
| 快速 | 有/无 | 迷你 | VideoSubFinder | |
| 自动 | 有| 大 | VideoSubFinder | 推荐 |
| 自动 | 无| 迷你 | VideoSubFinder | 推荐 |
| 精准 | 有/无| 大 | VSE | 非常慢 |
Windows/Linux/MacOS环境下字幕检测引擎都是VideoSubFinder
演示
- GUI版:点击查看GPU版本源码运行的安装教程 👈
源码使用说明
1. 安装 Python
请确保您已经安装了 Python 3.12+
- Windows 用户可以前往 Python 官网 下载并安装 Python
- MacOS 用户可以使用 Homebrew 安装:
shell
brew install [email protected]
- Linux 用户可以使用包管理器安装,例如 Ubuntu/Debian:
shell
sudo apt update && sudo apt install python3.12 python3.12-venv python3.12-dev
2. 安装依赖文件
请使用虚拟环境来管理项目依赖,避免与系统环境冲突
(1)创建虚拟环境并激活
shell
python -m venv videoEnv
- Windows:
shell
videoEnv\\Scripts\\activate
- MacOS/Linux:
shell
source videoEnv/bin/activate
3. 创建并激活项目目录
切换到源码所在目录:
shell
cd
例如:如果您的源代码放在 D 盘的 tools 文件夹下,并且源代码的文件夹名为 video-subtitle-extractor,则输入:
shell
cd D:/tools/video-subtitle-extractor-main
4. 安装合适的运行环境
本项目支持 CUDA(NVIDIA显卡加速)、CPU(无 GPU)、DirectML(AMD、Intel等GPU/APU加速)、ONNX四种运行模式
(1) CUDA(NVIDIA 显卡用户)
请确保您的 NVIDIA 显卡驱动支持所选 CUDA 版本
- 推荐 CUDA 11.8,对应 cuDNN 8.6.0
- 安装 CUDA:
- Windows:CUDA 11.8 下载
- Linux:
shell
wget https://developer.download.nvidia.com/compute/cuda/11.8.0/local_installers/cuda_11.8.0_520.61.05_linux.run
sudo sh cuda_11.8.0_520.61.05_linux.run
- MacOS 不支持 CUDA
- 安装 cuDNN(CUDA 11.8 对应 cuDNN 8.6.0):
- Windows cuDNN 8.6.0 下载
- Linux cuDNN 8.6.0 下载
- 安装方法请参考 NVIDIA 官方文档
Top issues
#243代码逻辑疑问19 comments · 2023-10-19#465进度始终卡在94%无法完成12 comments · 2026-08-12#246帧号到时间戳的耗时12 comments · 2023-10-20#130mac版有问题10 comments · 2022-05-28#58ES support10 comments · 2021-12-18#443一直停留在94%9 comments · 2026-06-02#43250系显卡不支持吗9 comments · 2026-04-10#367bro,你这个视频识别怎么只有七分钟啊?cpu版和gpu版都是?8 comments · 2024-12-29
Discussions
#466It stopped at 94%1 comments · 2026-08-17#436I would like to suggest ways to improve the software's Vietnamese language recognition accuracy.0 comments · 2026-05-07#435Several suggestions3 comments · 2026-04-29#434生成的.srt文件总是0字节,能不能跳过isa和ila图片处理,直接对rgb图片做OCR识别呢?isa和ila图片总是一片白色0 comments · 2026-04-22#433I only need to output subtitles, not render the video, so where do I install it?0 comments · 2026-04-21#424Tutorial unavailable0 comments · 2026-01-07#394gui.py无法批量处理2 comments · 2025-05-18#347Error with Chinese caracter2 comments · 2024-09-29
Latest release
硬字幕提取器 2.2.0 2.2.0 2026-04-04🚀 VSE v2.2.0 正式版发布✨ 🎉 新特性 · ⚡ 支持同步时间轴 · 🗂️ 支持设置字幕保存路径 · 🌐 添加土耳其语翻译 · 🧹界面优化 · 🐍 Python 3.13 + 升级PaddleOCRv5 准确率更高 · 💎 支持MacOS M系列芯片