YouDub-webui

liuzhao1225Apache-2.0活跃维护

开源 AI 视频本地化配音工具，把 YouTube/Bilibili 视频自动做语音识别、字幕翻译、声音克隆和混音渲染，一站式生成多语言配音成片。

Open-source AI video localization and dubbing for YouTube/Bilibili: speech recognition, subtitle translation, voice cloning, audio mixing and rendering. 开源 AI 视频翻译配音工具。

v0.0.12发布于 2026-11-03 10:35 UTC5,829star +17 / 7 天627fork同步于 2026-11-10 17:36 UTC

视频翻译 AI 配音语音识别声音克隆字幕翻译

对比 GitHub 官网 ai-dubbing ai-video-translation bilibili demucs fastapi

怎么上手

由 README 提炼，执行前请确认

原文

npm ci --registry=https://registry.npmmirror.com
npm --prefix apps/web ci --registry=https://registry.npmmirror.com
npm --prefix apps/harness ci --registry=https://registry.npmmirror.com
npm run build:framework
npm run build:youdub
npm start

硬件要求按 README 说明

README 未说明显存、GPU 厂商或型号要求；仅说明应用使用自己的 Python 环境与模型，首次启动需准备基础运行环境和各工作流所需推理依赖。

下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼

没人工点评？写下你的经验

开源视频本地化工作台，导入视频即可识别、翻译并逐句克隆原声，生成字幕与配音成片

开源 AI 视频本地化配音工具，把 YouTube/Bilibili 视频自动做语音识别、字幕翻译、声音克隆和混音渲染，一站式生成多语言配音成片。

核心能力

逐句原声克隆，每句译文用对应原文音频作参考
支持原声加字幕、配音、字幕加配音三种输出模式
Whisper 识别后用 NLTK Punkt 整理完整句子并取词级时间戳
按逗号顿号等拆分字幕显示，合并过短片段并隐藏末尾标点
任务库支持取消、重试、重新生成、播放与下载产物

容易踩的坑

首次启动需自行准备 Python 环境、模型和推理依赖，并按工作流分别准备资源；翻译需先在设置中添加模型供应商、密钥和翻译模型；源码运行需 Node.js ^22.19.0 || >=24.0.0 并初始化子模块，链接下载还依赖 yt-dlp 与 FFmpeg。

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

用户点评

登录用户的真实使用记录，可按版本和硬件筛选

共 0 条

还没有人点评。第一个说出真实体验的人最有价值。

README 原文

未翻译

在 GitHub 打开

YouDub Desktop

开源视频本地化工作台：导入视频，识别、翻译并逐句克隆原声，生成字幕和配音成片。

English · 官网与试听 · 下载最新版 · 安装与升级 · 社区交流

效果示例

默认演示为 2026-10-09 生成的黄仁勋采访：逐句原声克隆、中文字幕与背景音保留，完整时长约 59 秒。源视频链接用于说明样例出处，工作台支持视频链接和本地文件导入。

1. 黄仁勋采访 · 最新效果

原视频链接 · YouTube Shorts · 英文 -> 中文

https://github.com/user-attachments/assets/befd11ca-e720-4faa-b4e0-d89bfe73df87

https://github.com/user-attachments/assets/60d5dbb0-f346-4c14-adad-2d0c481ac4fb

2. 历史样例：How much YT paid me for 129 million shorts views

原视频链接 · YouTube 横屏长视频 · 英文 -> 中文 · 下方为开头 40 秒切片，完整版可在 demo-assets Release 下载

https://github.com/user-attachments/assets/bd02936f-cf3c-4e4b-85b5-0410d38f69f5

https://github.com/user-attachments/assets/158de60a-7de4-4ddf-b3d8-478d0423aee6

3. Me at the zoo

原视频 · 英文 → 中文 · 19 秒

在官网切换中英文试听。工作台和环境准备页的“查看官网示例”打开官网试听。安装包只保留黄仁勋采访原视频，可直接用作本地工作流输入。

能做什么

输出模式	生成内容
原声 + 字幕	保留原始音轨，生成并烧录目标语言字幕
配音	生成目标语言配音，可保留分离后的背景音
字幕 + 配音	输出带字幕的配音视频，可选语音强制对齐

逐句原声克隆。 每句译文使用对应原文句子的音频片段作为参考，保留句子与参考音频的一一对应关系。
字幕显示。 按逗号、顿号、中文破折号等拆分显示，合并过短片段，隐藏字幕片段末尾的分隔标点。
任务管理。 查看封面、步骤进度、错误和产物，支持取消、重试、重新生成、播放及下载。

工作台选择视频和工作流，并显示节点声明的快捷设置。语言、模型、设备、声音和字幕参数保存在工作流节点中；模型供应商、本地环境与模型安装在设置中管理。

界面预览

工作台：导入视频，选择语言和输出内容。

YouDub 工作台：视频导入、原文与目标语言、配音与字幕选项

任务库：视频封面、处理状态和历史任务。

YouDub 任务库：视频封面与已完成任务

任务详情：成片预览、处理步骤、配音音频和字幕下载。

YouDub 任务详情：带中文字幕的成片、八个已完成步骤与生成文件

下载与使用

Windows EXE 安装包 · macOS DMG · 版本说明与便携包

首次启动准备基础运行环境；所需模型和推理依赖按工作流准备。安装要求与升级方法见安装指南。

在首次配置或「设置 → 模型」添加供应商、密钥和翻译模型。
在「工作台」导入视频，选择工作流并调整节点选项，按提示准备所需资源后创建任务。
在「任务库」查看进度，播放或下载结果。

社区交流

QQ 交流群：618246010

从源码运行 YouDub Desktop

YouDub 提供视频翻译、配音、工作流编排与人工审核，使用 Electron 和裁剪后的 DeepSeek Harness 框架。开发请从文档索引、架构说明和本地运行开始。

使用 Node.js ^22.19.0 || >=24.0.0、npm、Git 和平台构建工具，首次检出时初始化子模块。在仓库根目录执行：

npm ci --registry=https://registry.npmmirror.com
npm --prefix apps/web ci --registry=https://registry.npmmirror.com
npm --prefix apps/harness ci --registry=https://registry.npmmirror.com
npm run build:framework
npm run build:youdub
npm start

npm start 与 npm run dev 启动同一 Electron 产品；npm run build:desktop 是 build:youdub 的别名，生成开发产物。npm run package:desktop -- --dir 生成独立应用；正式安装包、签名与发布见发行流程。浏览器调试、独立数据目录和修改后重建见本地开发。

首次启动选择界面语言和数据安装目录，在页面准备运行资源、配置翻译模型。应用使用自己的 Python 环境、模型和配置；翻译通过 Harness 模型服务调用，使用已配置的提供商协议和模型参数。基础环境和各工作流所需资源的准备状态分别展示。

已发布版本的源码运行、Swift/C# 桌面壳及发行流程见改造前说明。Harness 来源与保留范围见源码说明中。

Everything is a plugin

YouDub 使用 Cordis 插件运行时装配任务、工作流、字幕、配音、资源与业务页面。桌面窗口、连接、模型配置、LLM、子进程、Jobs 和插件管理复用保留的框架代码；应用使用自己的启动入口与运行目录。产品组合定义当前服务与页面。

YouDub Electron → Desktop Host ← Connection ← YouDub 页面
                         ↓
                 YouDub 工作流与任务插件
                         ↓
                 LLM / Subprocess / Jobs
                         ↓
                 翻译 / Python 媒体处理

前端使用 Harness Renderer、Slots、Layout、Store、主题、语言和通用控件，接入原 YouDub 业务组件、React Flow 画布及首屏动效。职责与源码映射见架构说明、前端开发及后端与工作流开发。

安装与开发插件

在应用的「扩展」页面管理插件，安装、启停和卸载由 Harness PluginManager 执行。节点、提供商和页面遵循 YouDub 业务合同；独立 Host/Client/Python 扩展的接入与示例见后端与扩展开发。当前没有已发布的 YouDub 在线插件市场。

当前范围

英文分句。 Whisper 识别后使用 NLTK Punkt 整理完整句子，并用词级时间戳确定原声范围；原始识别结果保留。
默认流程接收本地视频，由 FFmpeg 检查和处理实际音视频流；不设置视频时长、文件大小、分辨率或帧率上限。
当前语言目录包含英文、中文、日文，具体能力取决于提供者；可选 Qwen 对齐支持英文、中文。
节点工作流支持分叉、汇合与人工订正，按单槽串行执行；等待人工确认会释放执行槽。插件启停在重启后生效。热替换、插件市场、循环和分布式 worker 留待后续需求。
本地 workflow、Client 与 Python 插件已有验证；GitHub/npm 远端插件实装尚未验收。
当前 HTTP 接口为 /api/v2，支持从指定步骤重新生成任务。旧 FastAPI / v1 HTTP 入口已移除。链接下载通过 media.download/v1 接入现有任务流程，支持 YouTube、Shorts、B 站及 b23.tv 单视频链接；使用 yt-dlp、Node.js 与 FFmpeg，保留源视频质量，不设置时长和文件大小上限。

旧版本升级和数据迁移请先阅读运行指南。真实任务、迁移与未验证范围记录在迁移验收、逐句分句验收及字幕显示验收。

开发与测试

npm run typecheck
npm test
npm run test:backend
npm --prefix apps/web test
npm run lint:web
npm run build:youdub
npm --prefix apps/harness test

apps/harness/      Electron 产品入口、Host/Client 插件与开发工具
vendor/deepseek-harness/source/  Harness 框架活动 fork
packages/builtin/test/helpers/  领域测试夹具，产品由 Harness Host 启动
packages/sdk/      公共服务、workflow 与 operation 契约
packages/builtin/  基础服务、通用任务引擎、workflow 和模型桥
backend/workers/   Python 计算与 SQLite 事务桥
backend/app/       模型、媒体、凭据与历史数据格式
apps/web/          复用的业务组件、客户端逻辑、React 绑定与页面
fixtures/plugins/  独立 Host/Client/Python 插件示例
submodule/demucs/   Demucs 源码子模块

欢迎通过 Issue / PR 改进安装体验、适配模型、优化字幕与音画对齐，或提供独立来源/流程插件。docs/ 保留历史设计文档，当前开发入口以本文和 Desktop 开发指南为准。

开源许可

本项目使用 Apache License 2.0，详见 LICENSE。

国内镜像：AtomGit，由 GitHub 主仓库单向同步。Release、Issue 和 PR 在 GitHub 维护。

作者：刘朝 Zhao Liu · GitHub · Bilibili 黑纹白斑马

Star History