YouDub-webui

一键下载翻译配音，视频自动变中文版

YouDub-webui 是一个开源的 AI 视频本地化工具，旨在将 YouTube 或 Bilibili 视频自动翻译并配音成中文。它解决了视频内容跨语言传播中的人工翻译和配音成本高、效率低的问题。核心能力包括：自动下载视频、语音识别生成字幕、字幕翻译、使用 AI 语音克隆技术生成与原声相似的中文配音、音轨混合以及最终字幕压制。项目基于 Python 和 Next.js 构建，提供 Web UI 界面，支持 FastAPI 后端和 FFmpeg 音视频处理。用户可以通过简单的操作完成从视频下载到成品输出的全流程，适合个人创作者、自媒体团队进行视频本地化。

开源 free 音频音乐

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 5521

维护状态活跃

是否开源是

定价模式 free

项目数据

分类音频音乐

开发团队liuzhao1225

所属国家

官网地址

GitHubhttps://github.com/liuzhao1225/YouDub-webui

定价模式free

价格说明开源项目，Apache-2.0 许可证，可免费自行部署使用，无付费版本。

访问状态

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型ai-dubbing,ai-video-translation,bilibili,demucs,fastapi,ffmpeg,multilingual-video,nextjs,open-source,python,speech-to-text,subtitle-translation,text-to-speech,video-localization,video-translation,voice-cloning,voxcpm,whisper,youtube,youtube-translator

GitHub 星标★ 5521

30天Star增速

HF 下载量

上线时间2023-12-26 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：进阶约 60 分钟部署方式：本地安装 6 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Python 3.12
Node.js 20+
FFmpeg / ffprobe，且命令需在 PATH 中可用
可访问 YouTube 的代理及 Netscape 格式 YouTube Cookie
OpenAI 兼容 Chat Completions API 的 base URL、API key 和模型名
推荐 CUDA GPU，CPU 只能跑部分流程且非常慢

安装与启动步骤

1检查基础环境

确认已装 Python 3.12、Node.js 20+ 和 FFmpeg/ffprobe（需在 PATH 中）；Windows 可用 py -0p 查看已安装的 Python 版本。
```
py -0p
```
2获取项目代码

克隆仓库到本地；也可直接从 GitHub 页面下载源码压缩包解压使用。
```
git clone https://github.com/liuzhao1225/YouDub-webui
```
3安装依赖

按 README『3. 安装依赖』完成 Python 与 Node 依赖安装；本次节选未给出具体安装命令，请以仓库原文为准。
4创建配置文件

由示例文件复制出 .env，运行时读取该文件；注意不要把 API key、Cookie 等敏感信息提交到 Git。macOS/Linux 用 cp env.txt.example .env。
```
Copy-Item env.txt.example .env
```
5生成登录密码哈希

交互式输入访问密码，把输出的整行 Argon2id 哈希填入 .env 的 YOUDUB_AUTH_PASSWORD_HASH，不要填明文；macOS/Linux 改用 .venv/bin/python。
```
..venvScriptspython.exe -c "from getpass import getpass; from pwdlib import PasswordHash; print(PasswordHash.recommended().hash(getpass('YouDub password: ')))"
```
6启动服务

按 README『5. 启动服务』启动后端与 Next.js 前端；本节选未给出具体启动命令，请以仓库原文的启动说明为准。

关键配置

配置项	必填	说明	示例
`YOUDUB_AUTH_PASSWORD_HASH`	是	登录密码的 Argon2id 哈希，未配置时后端会拒绝启动	`$argon2id$v=19$m=65536,t=3,p=4$xxxxxxxx`
`FFMPEG_PATH`	否	FFmpeg 可执行文件完整路径	`C:/path/to/ffmpeg/bin/ffmpeg.exe`
`FFPROBE_PATH`	否	ffprobe 可执行文件完整路径	`C:/path/to/ffmpeg/bin/ffprobe.exe`
`OPENAI_BASE_URL`	是	翻译阶段使用的 OpenAI 兼容 API 地址	`https://api.openai.com/v1`
`OPENAI_API_KEY`	是	翻译阶段使用的 API key	`sk-xxxxxxxx`
`OPENAI_MODEL`	是	翻译阶段使用的 Chat Completions 模型名	`gpt-4o-mini`

如何确认成功

后端未配置 YOUDUB_AUTH_PASSWORD_HASH 时会拒绝启动；配置后能正常启动并用该密码登录 Web UI 即成功。

常见问题

Q：处理 YouTube 视频时下载失败怎么办？

A：需要能访问 YouTube 的网络环境，可在 .env 中设置 YTDLP_PROXY_PORT（如 7890）或 HTTP_PROXY，并配置 Netscape 格式的 YouTube Cookie。

Q：没有 CUDA 显卡还能用吗？

A：DEVICE=cpu 可运行部分流程，但完整转写、人声分离和 TTS 会非常慢；DEVICE=mps 时 Whisper 会自动退回 CPU，因词级时间戳依赖 MPS 不支持的 float64 DTW。

Q：启动直接失败是怎么回事？

A：最常见原因是 .env 中未配置 YOUDUB_AUTH_PASSWORD_HASH，后端默认强制认证并拒绝启动；请先按步骤生成哈希填入，且不要填明文密码。

Q：翻译阶段报错或想用本地模型？

A：确认 OPENAI_BASE_URL、OPENAI_API_KEY、OPENAI_MODEL 配置正确；使用本地 OpenAI 兼容服务时，建议把 localhost,127.0.0.1,::1 加入 NO_PROXY 避免请求绕行系统代理。

注意事项

不要提交 API key、Cookie、下载视频或生成产物到 Git，相关文件已被 .gitignore 排除。
首次运行会下载或加载较大的 ASR、TTS、音频处理模型，请预留磁盘空间与网络时间。
人声分离磁盘占用较大，按 44.1 kHz 双声道估算临时约 3.55 GiB/小时、最终输出约 1.18 GiB/小时，建议至少预留 4.73 GiB/小时。
POSIX 下会强制 umask 0077 并把 .env、Cookie、data/、WORKFOLDER 收紧为 owner-only，建议用专用 OS 用户运行。

核心亮点

全自动流水线：从下载到压制字幕一站式完成，无需手动干预
语音克隆配音：保留原声特色，提升观看体验
支持多平台：兼容 YouTube 和 Bilibili，覆盖主流视频源

不足之处

依赖外部服务（如语音识别和翻译 API），可能需要付费或配置密钥
文档/社区待观察：项目成长中，教程和问题解答可能不够完善

适用场景

将海外科技评测视频翻译成中文并配音，发布到国内平台
自媒体团队批量本地化 YouTube 教育内容，节省翻译成本
个人用户将喜欢的外语视频转为中文，方便理解

替代项目

VideoLingo、pyvideotrans、DubTube

项目介绍

YouDub-webui 是视频领域的开源项目，由 liuzhao1225 开发，2023 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（5,521）位列前 8%，在视频分类的 473 个项目里位列前 5%。

近 41 天，它的 GitHub 星标从 5,276 增加到 5,521，净增 245。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。Apache-2.0 许可证，可免费自行部署使用，无付费版本。

它主要面向的使用场景是：将海外科技评测视频翻译成中文并配音，发布到国内平台。同类可对比的替代方案包括 VideoLingo、pyvideotrans、DubTube。

上一篇：pyvideotrans

下一篇：OpenChatCut