pyvideotrans Documentation

File: docs/about.md Copy Chapter

👑捐助该项目，助力项目持续维护

本开源项目基于兴趣创建，没有商业计划，也就是你可以一直免费使用，或者fork后自己修改(必须遵守GPL-v3开源协议),不用担心免费版功能受限或闭源安全问题。

至于维护呢，开源嘛都是用爱发电，闲时就多花些精力在这上面，忙时可能就一段时间顾不上了。

当然了，如果觉得该项目对你有价值，希望该项目能一直稳定持续维护和优化，也欢迎各位小额捐助。

如果不愿捐助或者没有能力捐助，也无妨欢迎继续使用，点个star、提交个pr或关注下公众号(内容均是本项目教程，搜一搜公众号pyvideotrans )，也是对开发者的一种帮助。

如何捐助 Donate Methods Copy Chapter

你可以向微信或支付宝二维码付款，备注你的github名称

Donate URL at ko-fo.com: https://ko-fi.com/jianchang512

[pyVideoTrans项目](https://github.com/jianchang512/pyvideotrans)捐助者列表

感谢所有捐助者，您的支持是我坚持维护的动力

[ChatTTS-ui项目](https://github.com/jianchang512/chattts-ui)捐助者列表

未标注付款方式的即为微信支付，括号内标注为GitHub用户名，感谢所有支持者，软件的每一点进步都离不开您的支持和帮助。

File: docs/googlecloud_tts.md Copy Chapter

Google Cloud Text-to-Speech Integration

Overview Copy Chapter

This integration adds Google Cloud Text-to-Speech as a new TTS provider in VideoTrans. It offers high-quality voice synthesis with support for multiple languages and voices.

Features Copy Chapter

• Support for 16+ languages including:
  • Portuguese (Brazil)
  • English (US/GB)
  • Spanish
  • French
  • German
  • Italian
  • Japanese
  • Korean
  • Chinese
  • Russian
  • Hindi
  • Arabic
  • Turkish
  • Thai
  • Vietnamese
  • Indonesian
• Multiple voice options per language
• Adjustable speaking rate and pitch
• Support for multiple audio formats (MP3, LINEAR16, OGG_OPUS)
• User-friendly configuration interface

Requirements Copy Chapter

1. Python package:

   bash Copy

   pip install google-cloud-texttospeech>=2.14.0

2. Google Cloud Project:

   • Create a project in Google Cloud Console
   • Enable the Cloud Text-to-Speech API
   • Create a service account and download the credentials JSON file

Configuration Copy Chapter

1. In VideoTrans, go to Settings > Google Cloud TTS
2. Configure the following settings:
   • Credential JSON: Path to your Google Cloud service account credentials file
   • Language: Select the target language (e.g., "pt-BR" for Brazilian Portuguese)
   • Voice: Choose from available voices for the selected language
   • Audio Encoding: Select output format (MP3, LINEAR16, or OGG_OPUS)

Usage Copy Chapter

1. Select "Google Cloud TTS" as your TTS provider
2. Choose your target language
3. Select a voice from the available options
4. Adjust speaking rate and pitch if needed
5. Proceed with your video translation as usual

Troubleshooting Copy Chapter

Common issues and solutions:

1. "Credentials not found"

   • Verify the path to your credentials JSON file
   • Ensure the file has proper read permissions

2. "No voices available"

   • Check if your credentials have Text-to-Speech API access
   • Verify if the selected language is supported
   • Check the logs for detailed error messages

3. "Invalid speaking rate"

   • Speaking rate should be a percentage (e.g., "+10%", "-5%")
   • Default is "+0%"

4. "Invalid pitch"

   • Pitch should be in Hz (e.g., "+2Hz", "-1Hz")
   • Default is "+0Hz"

Contributing Copy Chapter

Feel free to:

• Report bugs
• Suggest improvements
• Add support for more languages
• Enhance the configuration interface

License Copy Chapter

This integration follows the same license as the main VideoTrans project.

Credits Copy Chapter

• Google Cloud Text-to-Speech API
• VideoTrans team for the base project
• Contributors who helped with this integration

File: docs/language.md Copy Chapter

English

添加语言包

1. 首先在控制台执行下面代码，查看系统当前语言代码

import locale
    locale.getdefaultlocale()[0]

将输出内容的前2个字符小写，拼接上.json作为文件名创建json文件，比如输出的是en_US,就创建 en.json 到 videotrans/language 目录下，这个en.json就是语言文件。

在软件启动时，会以该方式locale.getdefaultlocale()[0]的前2个字符小写，然后拼接.json，组成文件名，到 videotrans/language目录下搜寻,如果存在则使用，不存在则显示英文界面。
如果在 videotrans/set.ini 文件中 lang= 设置了值，则以该值为默认语言代码，否则以 locale.getdefaultlocale() 结果为准。

已存在en.json zh.json 2种语言文件，可直接复制后修改名称，在此基础上制作新的语言文件

每个语言文件都是一个json对象，最外层有4个字段，分别是

{
"translate_language":{},
"ui_lang":{},
"toolbox_lang":{}, 
"language_code_list":{}
}

其中 translate_language 是用于进度显示、错误提示、各种交互状态的文本，ui_lang 软件界面各个部件的显示名称，toolbox_lang 是视频工具箱界面各个部件的显示名称, language_code_list 是支持的语言显示名称

translate_language 修改 Copy Chapter

"translate_language": {
    "qianyiwenjian": "The video path or name contains non ASCII spaces. To avoid errors, it has been migrated to ",
    "mansuchucuo": "Video automatic slow error, please try to cancel the 'Video auto down' option",
}

如上，translate_language 是 字段名:字段值 组成的json对象，字段名不要动，字段值改为相应语言的文本即可。

ui_lang 修改 Copy Chapter

"ui_lang": {
"SP-video Translate Dubbing": "SP-video Translate Dubbing",
"Multiple MP4 videos can be selected and automatically queued for processing": "Multiple MP4 videos can be selected and automatically queued for processing",
"Select video..": "Select video..",
}
同 translate_language 的修改一样，字段名不要动，将字段值改为相应语言的文本即可。

toolbox_lang 修改 Copy Chapter

"toolbox_lang": {
"No voice video":"无声视频",
"Open dir":"打开目录",
"Audio Wav":"音频文件",
}
同 translate_language 的修改一样，字段名不要动，将字段值改为相应语言的文本即可。

language_code_list 的修改 Copy Chapter

"language_code_list": {
    "zh-cn":"Simplified Chinese",
    "zh-tw":"Traditional Chinese",
    "en":"English",
    "fr":"French",
    "de":"German",
    "ja":"Japanese",
    "ko":"Korean",
    "ru":"Russian",
    "es":"Spanish",
    "th":"Thai",
    "it":"Italian",
    "pt":"Portuguese",
    "vi":"Vietnamese",
    "ar":"Arabic",
    "tr":"Turkish",
    "hi":"Hindi"
  }

和其他一样，该内容字段名不要动，字段值改为要显示的名称

制作完成后，确认符合正确的 json 格式，然后放到 videotrans/language 目录下，重启软件就会自动应用该语言，如何你制作的语言包和默认语言不同，可通过设置 set.ini中 lang=语言代码和强制使用，比如 lang=zh将强制显示 zh.json 内容

Adding Language Packs

1. First, execute the following code in the console to check the system's current language code

import locale
    locale.getdefaultlocale()[0]

Lowercase the first 2 characters of the output content and append .json to create a json file as the filename. For example, if the output is en_US, create en.json in the videotrans/language directory, where en.json is the language file.

When the software starts, the system will take the first 2 characters lowercase from locale.getdefaultlocale()[0] and append .json to form the filename, and then look for it under the videotrans/language directory. If it exists, it will be used; otherwise, the English interface will be displayed.
If the lang= in the videotrans/set.ini file has a value set, then this value will be taken as the default language code, otherwise the result of locale.getdefaultlocale() will be used.

There are already en.json and zh.json 2 language files. You can copy and modify the name directly to create new language files.

Each language file is a json object. The outermost layer has 4 fields, which are

{
"translate_language":{},
"ui_lang":{},
"toolbox_lang":{}, 
"language_code_list":{}
}

Here translate_language is used for progress display, error prompts, various interaction states of text, ui_lang software interface display name of each component, toolbox_lang video toolbox interface display name of each component, language_code_list is the supported language display name

Modification of translate_language Copy Chapter

"translate_language": {
    "qianyiwenjian": "The video path or name contains non ASCII spaces. To avoid errors, it has been migrated to ",
    "mansuchucuo": "Video automatic slow error, please try to cancel the 'Video auto down' option",
}

As mentioned above, translate_language is a json object composed of field name: field value. Do not move the field name and change the field value to the corresponding language text.

Modification of ui_lang Copy Chapter

"ui_lang": {
"SP-video Translate Dubbing": "SP-video Translate Dubbing",
"Multiple MP4 videos can be selected and automatically queued for processing": "Multiple MP4 videos can be selected and automatically queued for processing",
"Select video..": "Select video..",
}
The same as the modification of translate_language, do not move the field name and change the field value to the corresponding language text.

Modification of toolbox_lang Copy Chapter

"toolbox_lang": {
"No voice video":"Silent video",
"Open dir":"Open directory",
"Audio Wav":"Audio file",
}
The same as the modification of translate_language, do not move the field name, and change the field value to the relevant language text.

Modification of language_code_list Copy Chapter

"language_code_list": {
    "zh-cn":"Simplified Chinese",
    "zh-tw":"Traditional Chinese",
    "en":"English",
    "fr":"French",
    "de":"German",
    "ja":"Japanese",
    "ko":"Korean",
    "ru":"Russian",
    "es":"Spanish",
    "th":"Thai",
    "it":"Italian",
    "pt":"Portuguese",
    "vi":"Vietnamese",
    "ar":"Arabic",
    "tr":"Turkish",
    "hi":"Hindi"
  }

Like the others, do not modify the field name of this content, change the field value to the display name

After the production is completed, make sure it meets the correct json format, put it into the videotrans/language directory, and the software will automatically apply the language when restarted. If the language pack you made is different from the default language, you can set set.ini in lang= language code and use it forcibly, such as lang=zh will forcibly display the content of zh.json