支持环境
- Global Tuber 是面向 Windows 10 / Windows 11 的桌面应用。
- 目前没有智能手机应用计划。
- 正在考虑开发 Mac 应用。
Check
开始前请先确认
使用 Global Tuber 前，请确认支持环境、许可证要求和设置项目。
开始前需要准备的内容
- 互联网连接
- Google 账号
- YouTube Data API
- DeepL API
显示设置
在 Global Tuber 设置中，可以更改设计和显示字体。如果文字难以阅读，请在开始工作前调整显示。
许可证
- 首次启动应用时必须输入许可证密钥。
- 每个 YouTube 频道需要一个许可证。
- 使用不同的 YouTube 频道时，需要单独的许可证。
在多台 PC 上使用应用
同一个 YouTube 频道可以在多台 PC 上使用。要在另一台 PC 上使用应用，请按相同步骤安装，必要时复制同一频道的程序文件夹。首次启动时需要再次输入许可证密钥。
免费版和付费版
- 免费版可使用 30 天。
- 付费版是买断式许可证。
- 只要支持环境和外部API仍可使用，就可以运行。
- 使用免费版至少三周后，可以购买付费版。
DeepL 字符数统计
应用中显示的 DeepL 字符数统计只是概算参考。我们不对应用中显示的统计数字准确性负责。准确的字符数请登录 DeepL 后确认。
支持联系方式
支持邮箱地址会显示在许可证认证画面，或显示在发送许可证密钥的邮件中。该邮箱地址不会发布在公开页面。
1
快速开始
首次使用者可以通过四个步骤确认必要准备。下面的编号章节会详细说明每一项。
从这里开始
确认基本设置，使用私人测试视频练习，确认输出位置，并了解出错时该查看哪里。
2
先完成基本设置
在尝试翻译和上传前，请先完成这些最低限度的设置步骤。
1
显示文件扩展名
打开文件资源管理器（用户文件夹）
在 Windows 中打开一个文件夹。可以使用用户文件夹，也可以使用任何其他文件夹进行此项确认。
在顶部菜单中选择“查看”。请参考下图。
在 Windows 11 中，从顶部菜单打开“查看”。
在“查看”菜单中选择“显示”。请参考下图。
将鼠标移到打开菜单底部附近的“显示”上。
勾选文件扩展名
显示 .json、.srt、.ytt、.txt 等扩展名后，更容易识别文件类型。
如果找不到此设置，请搜索“Windows 显示文件扩展名”。
2
重命名
重命名 client_secret.json
为 YouTube Data API 下载的认证文件名称很长。请将其重命名为下面的较短名称。
下载后立即看到的长文件名
client_secret_xxxxxxxx.apps.googleusercontent.com.json
重命名文件
client_secret.json
目标文件夹
config\client_secret.json
如果文件仍保留下载时的长文件名，认证将无法正常工作。
3
channel_info.json 频道 ID 和 default_language
channel_info.json 是 YouTube 频道信息的设置文件。它有两个版本：一个用于模板，一个用于 API 上传。
在模板中，只设置频道 ID 和主要语言，其他项目保持空白。本节说明如何填写模板。
确认模板位置
YouTube_Upload\Templates\channel_info.json
同时确认 API 上传的保存位置
YouTube_Upload\channel_info.json
确认频道 ID
打开你的 YouTube 频道。在频道 URL 中，channel/ 后面以 UC 开头的 24 字符值就是频道 ID。
面向多语言全球使用时，建议将
default_language 设为英语（en）For multilingual global use, even for channels outside English-speaking regions, set default_language to 英语（en）
这是由 YouTube 显示标题的方式决定的。如果标题没有翻译成观看者的语言，YouTube 会以 default_language 中设置的语言显示标题。
将英语设为默认语言，有助于尚未准备翻译的地区的观看者理解内容。
面向多语言全球使用时，也建议将频道名称的
default_language 设为英语（en）For multilingual global use, also set the channel-name default_language to 英语（en）
请使用清晰、简短的英文频道名称作为基础。
频道命名很重要，因为它可能会显著影响订阅增长和收入。
✔ 推荐方法（任一方式都可以很好地使用）
- 所有语言使用一个清晰、简短的英文频道名称
- 将
default_language设为英语，并使用翻译到各语言的频道名称
❌ 不推荐（可能会减慢增长）
- 在所有语言中原样使用非英文频道名称
- 使用英文和另一种语言各占一半的混合频道名称
面向多语言全球使用时如何指定
default_languageYouTube_Upload\Templates\channel_info.json
频道名称和频道说明模板
必填字段："channel_id" 和 "defaultLanguage"。建议使用 en。
"channel_id": "UCxxxxxxxxxxxxxxxxxxxxxx",
"defaultLanguage": "en"* 其他字段保持空白。
YouTube_Upload\Templates\metadata.json
视频标题和说明模板
必填字段："default_language"。建议使用 en。
"default_language": "en",* 其他字段保持空白。
不进行全球扩展时设置
default_language（主要语言）在 channel_id 中输入 YouTube 频道 ID。
在 default_language 中，通常输入主要源语言的代码。
使用 Translation-list.xlsx 的 YouTube-Code 列中的主要语言代码。
4
DeepL API 设置
主菜单 10。
在 DeepL 中复制 API 密钥的位置
- 登录 DeepL。
- 打开 DeepL 账号页面。
- 打开 DeepL 中的 API 密钥和使用限制页面。
- 选择 API 密钥旁边的 ⧉ 进行复制。
- 将其粘贴到 Global Tuber 的菜单 10 中。
API 密钥
ad22********3.fx⧉
10. 注册翻译 DeepL API 密钥
粘贴 API 密钥，然后按 Enter ↵：**********************
这是 DeepL API Developer API 密钥。
系统会根据 API 密钥自动检测你的方案
Enter the usage period start date and press Enter ↵
(Input format: 20261231）: 20260428
Enter the usage period end date and press Enter ↵
(Input format: 20261231）: 20270428
5
YouTube Data API 认证
主菜单 9。⇒ YouTube Data API 菜单 8。
使用 YouTube 频道的 Google 账号登录
登录 Google
xxxxxx@gmail.com
Choose an account如果有多个频道，请选择正确的 Google 账号
选择账号
xxxxxx@gmail.com
使用其他账号
如果出现“此应用未经 Google 验证”
Global Tuber 供频道所有者管理自己的 YouTube 频道。
如果你使用的是自己创建的 YouTube Data API 认证设置，请选择继续。
如果你使用的是从他人处收到的认证文件，或不认识其内容，请不要继续。
此应用未经 Google 验证
继续
Back to safety选择所有权限，然后选择继续
选择 Global Tuber 可以访问的权限
☑ 全选
☑ 管理 YouTube
☑ 管理 YouTube 视频
☑ 管理 YouTube 个人资料
打开收到的邮件并选择查看活动
已向 Global Tuber 授予访问权限
xxxxxx@gmail.com
Review activity认证成功后会创建 config\token.json。
安全注意事项
DeepL API key
config\client_secret.json
config\token.json
请妥善保管 API 密钥、认证文件、频道账号信息和个人信息。不要向他人披露。
如果使用付费 DeepL 方案，请在 DeepL 的成本控制设置中设置使用限制（字符数或费用）。
3
简明指南
从大约五种语言和一个私人测试视频开始，然后熟悉直到上传到 YouTube 的流程。
使用约五分钟的私人测试视频练习
从约五分钟的私人测试视频开始，重复练习从翻译到上传的流程。请在熟悉后再使用正式视频。
将源文件放入 Before_translation
Before_translation
Put the source files for translation here.
Title_and_Description.txtTitle_and_Description.txt 标题和说明源文件
Channel_Information.txtChannel_Information.txt 频道信息源文件
字幕文件SRT, etc.
用于自动显示字幕的标签
在 PC 上打开 YouTube Studio，在上传默认设置的标签中添加 yt:cc=on。对于已准备字幕的视频，字幕有时会默认显示。显示结果可能会因 YouTube 的规格和观看环境而变化。
- YouTube Studio
- 设置
- 上传默认设置
- 基本信息
- 标签
yt:cc=on
在 Translation-list.xlsx 中确认翻译对象和翻译引擎
１
在 Translation-list.xlsx 的 YouTube_Translation 工作表中，使用 Translation 列选择每种语言是否翻译。N 表示不翻译并复制原文，Y 表示进行翻译。
２
如果 Translation Engine 列为空，应用会使用标准免费翻译路线。SD 会在标题、频道名称等特别重要且较短的部分使用翻译精度较高的 DeepL（推荐）。D 会在所有翻译中使用 DeepL。
练习用五种语言翻译并上传标题 + 说明 + 字幕
标题 + 说明Translate and adjust as one text file
字幕Translate and create multilingual subtitles
检查结果Check and correct the applied content使用大约五种语言可以让结果更容易检查，并让你每天大约练习上传四次。
将所有语言的标题控制在 100 个字符以内
１
检查哪些语言超过 100 字符限制，以及超过了多少字符。
２
稍微缩短源标题并保存。
３
按 Enter 键继续。只有超过限制的语言会重新翻译。
只有 100 字符以内的标题会被保存为 API 上传和手动上传的文件。
也可以设置不翻译的术语
◀❎⛔ @Username ⛔❎▶
将不希望翻译的术语放在上方所示的一行不翻译标签之间。换行会使标签无效。
可用于频道名称、账号名、品牌名、产品名、专有名词，以及其他翻译后含义会改变的术语。
检查输出位置
用于 API 上传YouTube_Upload\VIDEO_IDTitle, description, and subtitle files used by YouTube Data API are saved here.
用于手动上传After_translationTranslated files for manual upload to YouTube are saved here.使用 YouTube Data API 上传
一起上传标题、说明和字幕
使用 YouTube_Upload\VIDEO_ID 中的 API 文件，一起上传标题、说明和字幕。
重新加载（ ⟳ ）YouTube Studio 视频的字幕页面并检查。
使用私人测试视频反复练习从翻译到上传的流程，等熟悉后再用于正式视频。标题、说明和字幕可以任意次数修正并重新上传。不过，频道名称在 14 天内只能更改两次。
使用 Placeholder 工作表在字幕中插入固定文案
在 Translation-list.xlsx 的 Placeholder 工作表中，为 {WELCOME_WITH_THANKS_1} 和 {REQUEST_FOR_COMMENTS_1} 等占位符登记固定文案。
在字幕中写入占位符后，可以向各语言字幕插入问候、感谢、评论请求等固定文案。希望提高观众互动时使用。
示例：你好。致所有用简体中文观看的朋友们，以及全世界的各位。希望这个视频能对大家有一点帮助。
4
任务指南
使用本节查找每项任务应确认的位置。
Translation
Subtitles
Upload
DeepL
Authentication
Error handling
源文件夹
Before_translation
将源标题、说明、频道信息和字幕文件放在这里。
已翻译文件夹
After_translation
用于手动上传到 YouTube 的已翻译文件会保存在这里。
API 上传文件夹
YouTube_Upload\VIDEO_ID
YouTube Data API 使用的标题、说明和字幕文件会保存在这里。
YouTube Data API 文件夹
YouTube_Upload
YouTube Data API 使用的频道信息文件会保存在这里。
模板文件夹
YouTube_Upload\Templates
标题、说明和频道信息的模板文件会保存在这里。
翻译
翻译标题 + 说明
- 翻译
Title_and_Description.txt，并将所有语言的标题调整到 100 个字符以内。 - 在
Translation-list.xlsx的MAX_LENGTHS工作表中，将文本调整到字符限制以内。 - 合并后的输出文件会以
Title_and_Description_xxxxxx_xxxxxx-★Concatenation.txt格式保存。
翻译字幕
将 SRT 字幕转换为可以使用彩色项目符号的 YTT 或 TTML 字幕，或将标准 SRT、YTT 和 TTML 字幕翻译成多种语言。
- YTT 字幕YouTube subtitle format can express the widest range of styles, including color bullets. This is the recommended format.
- TTML 字幕YouTube, but the available expression range is limited. It is officially supported by YouTube, but only a small part of the TTML specification can be used.
- SRT 字幕
一起翻译标题、说明和字幕
- 用于连续翻译标题 + 说明，并将 SRT 转为 YTT 或 TTML 字幕。
- 如果希望在同一任务中处理字幕，而不是只处理标题和说明，请选择此项。
翻译并更新频道信息
- 翻译
Channel_Information.txt，并为多种语言准备频道名称和说明。 - 在
Translation-list.xlsx的MAX_LENGTHS工作表中，将文本调整到字符限制以内。 - 合并后的输出文件会以
Channel_Information_xxxxxx_xxxxxx-(★Concatenation).txt格式保存。 - 频道信息支持的语言少于视频元数据。
移动字幕块并调整时间
- 运行程序时，屏幕上会显示说明。请比较执行前后
Time_Editing文件夹中的示例文件，以理解结果。 - 移动部分字幕，并调整编号和时间戳。
- 按照执行时显示的手册操作，并比较调整前后的示例。
- 一起调整
Time_Editing文件夹中的字幕。
上传和配置
上传到 YouTube
使用 API 上传时，请使用 YouTube_Upload\VIDEO_ID 文件夹中的文件。手动上传时，请使用 After_translation 文件夹中的文件。
设置并检查 DeepL API
主菜单 10。
设置 API 密钥和使用期间，以便开始翻译。如果使用付费方案，请在 DeepL 的成本控制页面设置字符数或费用限制。
[重要] 请安全保存 DeepL API 密钥，切勿共享。
使用 YouTube Data API 进行认证
主菜单 9。⇒ YouTube Data API 菜单 8。
选择 YouTube 频道的 Google 账号，确认 Google 权限，并确认邮件。认证后，检查 config\token.json。
[重要] 标题和频道名称必须设置主要语言（默认语言）。如果未设置，就无法上传。以后也无法删除标题和频道名称的主要语言。
请安全保存 config 文件夹中的文件，切勿共享。
调研
使用 YouTube API 的三种调研工具
主菜单 9。⇒ 使用下面三个菜单
- 5. 按语言分析 YouTube 关键词搜索：
YT_Search.xlsx - 6. 频道详细分析：
YT_channel.xlsx - 7. 频道评论和语言比例：
YT_Comment.xlsx
首次运行下载的示例数据时，调研文件会保存在 YouTube_Upload 文件夹中。
之后请参考下载的 YT_Search.xlsx、YT_channel.xlsx 和 YT_Comment.xlsx 文件进行编辑。
* 请在不上传标题、说明或字幕的日子进行调研。调研和上传共用每日限额。
最后的详细说明章节会解释技术细节。请先只打开你需要的任务。
View
5
故障排查
选择症状，查找可能原因和修复步骤。
1. 无法认证 YouTube
在创建 API 密钥后，如果你的邮箱地址没有在 OAuth 设置中注册为测试用户，YouTube Data API 设置期间可能会发生这种情况。使用错误的 Google 账号登录时也可能发生。
请使用 YouTube 频道的 Google 账号重新登录，并在需要时检查 YouTube Data API 中的 OAuth 设置。
如果以前认证过的 API 密钥突然出现认证错误，请先删除 config\token.json 并重新认证。如果仍未解决，请删除 config 文件夹中的认证文件，获取新的 YouTube Data API 密钥，并重新认证。
2. 所有权错误
当你没有使用 YouTube 频道对应的 Google 账号登录时，会发生此错误。请使用正确的频道账号重新登录。
3. 今日配额已超出
对于新视频，通常每天最多可以上传 24 种语言的标题、说明和字幕。
这会使用每日 YouTube API 配额，因此最好将上传和调研安排在不同日期。
4. 没有可上传的文件
如果文件已经上传，目标文件可能已被移动到 Completion 文件夹。请重新翻译，或从 YouTube_Upload\11-character video ID folder name\Completion 将目标文件移回。
5. 临时翻译引擎错误
翻译引擎服务器可能繁忙。请稍等后再次运行任务。服务端点可能因国家和环境而异，因此这不一定是你能直接解决的问题。
6. 调研文件显示异常
在旧版 Microsoft Excel 或兼容 Excel 的软件中，缩略图和条件格式图表可能无法正确显示。请用较新的 Microsoft Excel 打开文件。
7. 手动自定义 YTT / TTML 出错
如果标签结构被破坏，手动编辑 YTT / TTML 将超出支持范围。请恢复为与示例相同的结构，然后再次运行任务。
8. 先检查屏幕上的消息
Global Tuber 通常会显示为什么停止以及下一步该做什么。请先阅读显示的消息，并检查相关项目。
1Identify the symptomCheck the error message and situation
2Identify the causeCheck common causes
3Solution stepsRun the corrective steps
4Check againCheck whether it works correctly
如何读取状态
正常：未检测到问题
提示：检查设置或环境
错误：需要执行操作
不要只依赖显示的状态。还要检查刚才选择的菜单编号以及文件保存位置。
If a problem cannot be resolved using this manual and the messages shown by the app, note the situation and contact the email address shown during license authentication or the email address that sent your license key. Include all files in the System\Logs folder.
6
详细说明
确认每个文件夹和设置文件的用途。
主要文件夹和文件
本节汇总手册中反复出现的文件夹和文件的作用。如果工作中不确定该看哪里，请先查看此表。
| 名称 | 作用 | 何时检查 |
|---|---|---|
| 整体流程 | 将源文件放入 Before_translation。手动操作时检查 After_translation。使用 API 时检查 YouTube_Upload\VIDEO_ID。 | 先确认整体流程时 |
Before_translation |
此文件夹保存翻译前的源文件。处理前，请将标题 + 说明、频道信息和字幕文件放在这里。 | 运行翻译前 |
After_translation |
用于手动上传到 YouTube 的已翻译文件会保存在这里。 | 手动上传前 |
YouTube_Upload\VIDEO_ID |
此占位文件夹名称用于 YouTube Data API 上传文件示例。检查真实上传文件夹时，请将其替换为实际视频 ID。 | API 上传前 |
YouTube_Upload\11-character video ID folder name |
这是每个视频实际使用的上传文件夹。它包含上传前 YouTube Data API 使用的标题、说明和字幕文件。 | API 上传前 |
YouTube_Upload\11-character video ID folder name\Completion |
上传完成后，标题、说明和字幕文件会保存在这里。如果多次上传同一视频，文件不会被覆盖，而是作为过去的备份保留。 | API 上传后 |
YouTube_Upload |
YouTube Data API 使用的频道信息文件会保存在这里。 | 检查频道信息时 |
YouTube_Upload\Templates |
标题、说明和频道信息的模板文件会保存在这里。对于频道信息，频道 ID 和主要语言（默认语言）设置尤其重要。 | 使用输入模板时 |
Title_and_Description_xxxxxx_xxxxxx-★Concatenation.txt |
此翻译输出文件会合并标题和说明。用于一起检查已翻译标题和说明。 | 翻译标题和说明后 |
Channel_Information_xxxxxx_xxxxxx-(★Concatenation).txt |
此翻译输出文件会合并频道信息。用于检查多语言频道名称和说明。 | 频道信息翻译后 |
YouTube_Upload\channel_info.json |
此文件设置频道 ID 和 default_language。面向多语言全球使用时，建议将 default_language 设为 en。 | 基本设置期间或更换频道时 |
config\client_secret.json |
这是为 YouTube Data API 下载的认证文件。请将下载时的长文件名重命名为此名称，并放在这里。 | YouTube 认证前 |
config\token.json |
此文件会在 YouTube 认证后创建，用于保存认证状态。不要发布，也不要交给他人。 | YouTube 认证期间或发生认证错误时 |
System\Logs |
此文件夹保存错误和处理日志。如果发生问题，请检查问题发生时间附近的日志。 | 检查错误详情时 |
YTT-Settings.xlsx |
Use this file for YTT subtitle design settings. When checking color bullets and other display options on YouTube, check this file first. YTT and TTML are different formats, so configure them separately when using both. If you edit it manually, back up the original file first and refer to ytt.ytt. Only some items from the reference material are used for YTT settings. Display results may differ by viewing device. Editing YTT-Settings.xlsx or YTT subtitle files manually is outside support. |
更改 YTT 字幕的位置或颜色时 |
TTML-Settings.xlsx |
Use this file for TTML subtitle design settings. Check it when changing subtitle position, color, or display rules. If you edit it manually, back up the original file first and refer to TTML1. On YouTube, only part of TTML1 color and position support is available. Editing TTML-Settings.xlsx or TTML subtitle files manually is outside support. |
更改 TTML 字幕的位置或颜色时 |
| 不翻译标签 | 使用一行不翻译标签保护不得翻译的术语。换行会使其无效。 | 保护 URL、账号名或品牌名时 |
| 手动自定义 | 手动编辑 YTT 或 TTML 时，请保持与示例相同的结构。如果标签结构被破坏，可能会发生错误。编辑 YTT-Settings.xlsx 或 YTT 字幕文件不在支持范围内。编辑 TTML-Settings.xlsx 或 TTML 字幕文件不在支持范围内。 | 手动编辑字幕后 |
| 如果问题未解决 | 只有在检查故障排查、FAQ 和详细说明后问题仍未解决时，才联系支持。请整理显示的消息、运行过的任务以及当时情况的详细信息。 | 联系支持前 |
| 安全注意事项 | 请安全保存 API 密钥、config\client_secret.json、config\token.json、频道账号信息和个人信息。不要向他人披露。 | 发送日志或屏幕截图前 |
7
FAQ
Q
我应该先尝试什么？
A
先从私人测试视频开始，用大约五种语言反复尝试标题、说明和字幕。熟悉后，再进行频道信息和正式视频上传。
Q
应该使用 YTT 还是 TTML？
A
大多数情况下，请使用更容易编辑的 YTT。仅在需要时选择 TTML。它们是不同的字幕格式，因此相同设置不一定会产生完全相同的外观。
Q
为什么标题必须在 100 个字符以内？
A
YouTube 标题有 100 字符限制。稍微缩短源标题后，只有超过限制的语言会重新翻译。只有 100 字符以内的标题会保存为 API 上传和手动上传的文件。
Q
什么时候应该使用不翻译标签？
A
用于翻译后会造成问题的术语。例如 @账号名、URL、#标签、品牌名、型号名、带符号的术语，以及翻译后含义会改变的术语。
Q
API 上传和手动上传有什么区别？
A
YouTube_Upload\VIDEO_ID 用于 API 上传。After_translation 用于手动上传。要检查的文件夹取决于使用的方法。
Q
可以多次上传吗？
A
对于私人测试视频，可以根据需要反复练习。但是，YouTube Data API 有每日使用限制（配额），如果达到限制，请在之后的日期再次运行任务。请在完全熟悉后，再将流程用于正式视频。
Q
什么时候处理频道信息？
A
请在熟悉标题、说明和字幕的翻译与上传后再处理。频道信息影响范围更广，因此请先使用私人测试视频学习基本流程。
Q
在哪里可以阅读详细技术说明？
A
只有需要的用户才应阅读最后的详细说明章节。通常使用时，请查看简明指南、任务指南、故障排查和 FAQ。