mpv-AI-sub-fastwhisper

项目概述

mpv-AI-sub-fastwhisper 是一款运行在 mpv 上的字幕脚本，通过 faster-whisper 对视频语音进行转录，自动生成 SRT 字幕。字幕生成后，脚本会调用 GPT API 把内容翻译成目标语言（默认中文），最终以双语形式叠加显示。它基于 dyphire 的同名项目分支而来，并把安装与配置过程整理成了详细的图文教程。

按一个快捷键，让视频自己长出双语字幕。

主要功能

• 语音转录：调用 faster-whisper 对当前视频的音频做识别，生成 SRT 字幕
• 自动翻译：转录完成后调用 GPT API 翻译为目标语言，默认中文
• 双语显示：上排显示中文译文，下排显示原文，配色区分便于对照
• 快捷键触发：在播放中按 Alt + F 即可开始识别、生成与翻译
• 图文教程：从下载识别程序、放置模型到配置脚本选项，一路带图讲解
• 可配置选项：语音识别程序路径、模型、目标语言与 GPT API 等均在脚本选项中设置

适用人群

• 观看无字幕外语视频的用户
• 想在 mpv 里直接获得双语字幕的人
• 具备 NVIDIA 显卡、愿意本地跑识别的用户
• 需要批量生成字幕的影音爱好者

快速上手

1. 准备一张 NVIDIA 显卡（显存建议 6GB 以上），并安装 7-Zip 或 WinRAR
2. 创建目标文件夹，例如 D:\000\ai-whisper\ 与 D:\000\mpv\
3. 从 Purfview 的发布页下载 Faster-Whisper-XXL（选 r245.4 版本），解压到 ai-whisper 目录
4. 在 ai-whisper 下新建 _models 文件夹，并下载 faster-whisper-large-v3 模型放入
5. 把本脚本与配置放入 mpv 的 scripts 与 script-opts 目录
6. 在脚本选项中填写识别程序路径与 GPT API 配置，播放视频时按 Alt + F 触发

核心优势

• 本地识别：语音转录在本机完成，不必上传视频
• 一步出双语：识别、翻译与叠加显示一条链路走完
• 教程详尽：每个步骤都配图，新手也能照着做完
• 选项灵活：模型、目标语言与接口都可按需调整

系统要求

项目	要求
操作系统	Windows
硬件	NVIDIA 显卡，显存建议 6GB 以上
依赖	faster-whisper 语音识别引擎、FFmpeg、mpv 播放器
可选	GPT API（用于字幕翻译）

注意事项

• 需要自行准备 GPT API 配置，否则只能生成原文无法翻译
• 模型文件体积较大，下载与识别都需要一定时间与磁盘空间
• 识别速度与质量取决于显卡性能与所选模型
• 请勿把包含密钥的配置文件公开分享