Video Subtitle Remover 使用教程-cmzhiku

项目简介

Video-Subtitle-Remover (VSR) 是一款基于 AI 技术的视频硬字幕去除工具。它能够无损分辨率地将视频中的硬字幕和文字水印去除，通过超强 AI 算法模型对去除区域进行智能填充，效果远超传统的相邻像素填充方式。

支持自定义字幕位置精准去除，也支持全视频自动识别并去除所有文本内容，还能批量处理图片中的水印文字。最重要的是：无需申请任何第三方 API，全部本地运行，完全免费！

💡
GitHub 地址：
https://github.com/YaoFANGUK/video-subtitle-remover

核心亮点

🎯 无损分辨率

去除字幕后画面质量不损失，AI 智能填充去除区域

🆓 完全免费

无需任何 API 和 Token，本地运行零成本

🖥️ GPU 加速

支持 NVIDIA CUDA 和 AMD DirectML 加速

🐳 Docker 部署

一行命令即可启动，支持多种 GPU 架构

环境要求

Python：3.12+
操作系统：Windows / Linux / macOS（macOS 不支持 CUDA）
显卡：推荐 NVIDIA 显卡（CUDA 加速），也支持 AMD / Intel 显卡（DirectML）
CUDA：推荐 11.8 版本，搭配 cuDNN 8.6.0

⚠️ 如果不确定显卡适合哪个 CUDA 版本，可以参考 NVIDIA CUDA GPUs 查看计算能力列表。

快速开始（推荐：预构建包）

最简单的方式是直接下载预构建压缩包，解压后即可运行，无需配置环境：

步骤 1

下载预构建包

根据你的显卡类型选择对应版本：

包名	适用环境	计算能力
vsr-windows-directml	AMD / Intel 显卡	通用
vsr-windows-nvidia-cuda-11.8	CUDA 11.8	3.5 – 8.9
vsr-windows-nvidia-cuda-12.6	CUDA 12.6	5.0 – 8.9
vsr-windows-nvidia-cuda-12.8	CUDA 12.8	5.0 – 9.0+

步骤 2

解压运行

解压下载的压缩包，双击运行即可启动图形界面。

Docker 一键部署

如果你有 Docker 环境，一行命令即可启动：

NVIDIA 10/20/30 系显卡

bash

docker run -it --name vsr --gpus all eritpchy/video-subtitle-remover:1.1.1-cuda11.8

NVIDIA 40 系显卡

bash

docker run -it --name vsr --gpus all eritpchy/video-subtitle-remover:1.1.1-cuda12.6

NVIDIA 50 系显卡

bash

docker run -it --name vsr --gpus all eritpchy/video-subtitle-remover:1.1.1-cuda12.8

AMD / Intel 显卡

bash

docker run -it --name vsr --gpus all eritpchy/video-subtitle-remover:1.1.1-directml

源码安装

步骤 1

克隆项目 & 创建虚拟环境

bash

git clone https://github.com/YaoFANGUK/video-subtitle-remover.git
cd video-subtitle-remover
python -m venv videoEnv
videoEnv\Scripts\activate   # Windows
# source videoEnv/bin/activate   # macOS/Linux

步骤 2

安装依赖（CUDA 11.8 版本）

bash

# 安装 PaddlePaddle GPU 版
pip install paddlepaddle-gpu==3.0.0 -i https://www.paddlepaddle.org.cn/packages/stable/cu118/

# 安装 PyTorch GPU 版
pip install torch==2.7.0 torchvision==0.22.0 --index-url https://download.pytorch.org/whl/cu118

# 安装其他依赖
pip install -r requirements.txt

💡 AMD/Intel 显卡用户请使用 DirectML 版本，安装命令略有不同，详见 GitHub README。

步骤 3

运行程序

bash

# 图形界面版
python gui.py

# 命令行版
python ./backend/main.py

去除算法说明

VSR 提供三种 AI 去除算法，可在 backend/config.py 中切换：

算法	适用场景	速度	特点
STTN	真人视频	快	可跳过字幕检测，效果较好
LAMA	图片/动画视频	一般	图片效果最好，不可跳过检测
ProPainter	运动剧烈的视频	较慢	显存消耗大，效果好