Video-Subtitle-Remover使用教程：零基础上手AI字幕去除工具

1. 核心功能解析

Video-Subtitle-Remover是一款基于AI技术的开源工具，能自动检测并去除视频中的硬字幕（画面中嵌入的文字）和文本水印。通过三大AI算法模块协同工作：

• 字幕检测模块：精准识别视频帧中的文字区域（支持自定义区域）
• 智能填充模块：采用LAMA/STTN/PROPAINTER三种算法修复字幕区域
• 视频处理模块：保持原始分辨率，无损重建去字幕视频

🔍功能模块关系：用户通过GUI界面发起任务→字幕检测模块定位文字→智能填充模块修复画面→视频处理模块输出最终文件

2. 环境配置三步骤

2.1 准备基础环境

🔍确保你的电脑满足：

• 系统：Windows/macOS/Linux
• 硬件：Nvidia显卡（至少GTX 1060）+ 8GB以上显存
• 基础软件：Python 3.8+、Git

2.2 获取项目源码

git clone https://gitcode.com/gh_mirrors/vi/video-subtitle-remover
cd video-subtitle-remover  # 进入项目目录

2.3 创建虚拟环境

# 创建专属环境（避免干扰其他软件）
conda create -n vsr-env python=3.8
conda activate vsr-env  # 激活环境（命令行前出现(vsr-env)表示成功）

3. 快速上手四步法

3.1 安装核心依赖

# 安装CUDA加速的PaddlePaddle（文字检测引擎）
pip install paddlepaddle-gpu==2.4.2.post117 -f https://www.paddlepaddle.org.cn/whl/linux/mkl/avx/stable.html

# 安装PyTorch（AI修复框架）
pip install torch==2.0.1 torchvision==0.15.2 --index-url https://download.pytorch.org/whl/cu118

# 安装其他依赖包
pip install -r requirements.txt  # 从配置文件批量安装

🔍预期结果：命令执行完毕后无Error提示，部分包会显示Successfully installed

3.2 启动图形界面

python gui.py  # 运行可视化程序

🔍预期结果：出现带"视频字幕去除"字样的窗口界面，包含文件选择和开始处理按钮

3.3 处理视频文件

🔍操作流程：

1. 点击"选择视频"按钮导入需要处理的文件（支持mp4/mkv等格式）
2. 选择输出目录（默认保存在原视频同目录）
3. 点击"开始处理"按钮（首次运行会自动下载模型文件，需等待5-10分钟）
4. 处理完成后在输出目录找到"_nosub"结尾的新视频

3.4 查看处理结果

🔍预期效果：新视频中原本的字幕区域被完美填充，画面流畅无明显痕迹

4. 核心配置详解

4.1 配置文件作用

backend/config.py是调节处理效果的核心文件，通过修改参数可以：

• 平衡处理速度与效果质量
• 适配不同硬件配置（显存大小）
• 针对特殊视频类型优化算法

4.2 常用配置修改

# 1. 提升处理速度（适合低配电脑）
MODE = InpaintMode.STTN  # 选择STTN算法
STTN_SKIP_DETECTION = True  # 跳过重复字幕检测

# 2. 优化动画视频效果
MODE = InpaintMode.LAMA  # 切换LAMA算法
LAMA_SUPER_FAST = False  # 关闭极速模式

# 3. 处理高分辨率视频
PROPAINTER_MAX_LOAD_NUM = 50  # 减少同时处理帧数（降低显存占用）

🔍修改方法：用记事本打开config.py，找到对应参数修改后保存，重启程序生效

5. 常见问题解决

5.1 程序启动失败

🔍问题表现：运行python gui.py后窗口闪退 🔍解决方案：

# 检查CUDA是否安装成功
nvidia-smi  # 能看到显卡信息说明驱动正常
# 重新安装PyTorch
pip install torch==2.1.0 --index-url https://download.pytorch.org/whl/cu118

5.2 处理后仍有字幕残留

🔍问题表现：视频某些帧的字幕未被完全去除 🔍解决方案：

1. 修改配置文件：STTN_SKIP_DETECTION = False（开启完整检测）
2. 增大字幕区域偏差值：SUBTITLE_AREA_DEVIATION_PIXEL = 30
3. 切换算法为LAMA：MODE = InpaintMode.LAMA

提示：所有修改需重启程序生效，建议先备份原始config.py文件