liuzhao1225 /YouDub-webui

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

★ 5,848⑂ 629👁 35⑃ 102● 96▤ 14
TypeScriptApache-2.0Created 2023-12-26liuzhao1225.github.io/YouDub-webui/
Download: YouDub v0.0.13YouDub-0.0.13 ↓0.0.132026-11-13
+6
Daily
5,848
stars
629
forks
35
watchers
102
prs
96
issues
14
releases

README

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 · 版本说明与便携包

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

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

 社区交流

QQ 交流群:618246010


  


 从源码运行 YouDub Desktop

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

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

bash
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 和插件管理复用保留的框架代码;应用使用自己的启动入口与运行目录。产品组合定义当前服务与页面。

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


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

 安装与开发插件

在应用的「扩展」页面管理插件,安装、启停和卸载由 Harness PluginManager 执行。节点、提供商和页面遵循 YouDub 业务合同;独立 Host

Top issues

Latest release

YouDub v0.0.13 v0.0.13 2026-11-13
- 修复 196 的长视频翻译中断。Whisper 按句重新对齐词时间戳,翻译每次只处理当前句,已完成的句子可在任务重试时继续使用。
- 翻译模型需支持结构化输出及 65,535 的输出上限。官方 DeepSeek 路由使用 Responses 接口。
- 修复环境准备阶段下载源过早超时的问题,并加入桌面应用后台下载与安全重启更新。已有 v0.0.12 安装需手动升级一次。

Windows x64 安装程序 · Windows x64 ZIP · macOS Apple Silicon DMG

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON