jianchang512 /pyvideotrans
Translate the video from one language to another and embed dubbing & subtitles.
★ 19,753⑂ 2,457👁 104⑃ 226● 980▤ 97
More from this author
+10
Daily
19,753
stars
2,457
forks
104
watchers
226
prs
980
issues
97
releases
README
pyVideoTrans | Sponsors || | :--- | :--- | | Recall.ai Meeting Transcription API | If you’re looking for a transcription API for meetings, consider checking out Recall.ai , an API that works with Zoom, Google Meet, Microsoft Teams, and more | | OfoxAI: Text, speech, image and video model APIs | Access GPT, Claude, Gemini and DeepSeek text models, ElevenLabs speech models, and image and video generation models with one API key—choose the models that fit your creative needs. | --- A Powerful Open Source Video Translation / Audio Transcription / AI Dubbing / Subtitle Translation Tool 中文 | Documentation | Online Q&A | Edit Document pyVideoTrans is dedicated to seamlessly converting videos from one language to another, offering a complete workflow that includes speech recognition, subtitle translation, multi-role dubbing, and audio-video synchronization. It supports both local offline deployment and a wide variety of mainstream online APIs. --- Core Features Technical Architecture and Principles - Fully Automatic Video Translation: One-click workflow: Speech Recognition (ASR) → Subtitle Translation → Speech Synthesis (TTS) → Video Synthesis. - Audio Transcription / Subtitle Generation: Batch convert audio/video to SRT subtitles, supporting Speaker Diarization to distinguish between different roles. - ️Multi-Role AI Dubbing: Assign different AI dubbing voices to different speakers. - Voice Cloning: Integrates models like F5-TTS, CosyVoice, GPT-SoVITS for zero-shot voice cloning. - Powerful Model Support: - ASR: Faster-Whisper (Local), OpenAI Whisper, Alibaba Qwen, ByteDance Volcano, Azure, Google, etc. - LLM Translation: DeepSeek, ChatGPT, Claude, Gemini, MiniMax, Ollama (Local), Alibaba Bailian, etc. - TTS: Edge-TTS (Free), OpenAI, Azure, Minimaxi, ChatTTS, ChatterBox, etc. - ️Interactive Editing: Supports pausing and manual proofreading at each stage (recognition, translation, dubbing) to ensure accuracy. - ️Utility Toolkit: Includes auxiliary tools such as vocal separation, video/subtitle merging, audio-video alignment, and transcript matching. - Command Line Interface (CLI): Supports headless operation, convenient for server deployment or batch processing. - Web Interface (WebUI): Browser-based interface for remote access or internal network deployment. --- Quick Start (Windows Users) We provide a pre-packaged .exe version for Windows 10/11 users, requiring no Python environment configuration. 1. Download: Click to download the latest pre-packaged version 2. Unzip: Extract the compressed file to a path without Chinese characters or spaces (e.g., D:\pyVideoTrans). 3. Run: Double-click sp.exe inside the folder to launch. Note: Do not run directly from within the compressed archive. To use GPU acceleration(NVIDIA GPU only), ensure CUDA 12.8 and cuDNN 9.11 are installed. --- ️ Source Deployment (macOS / Linux / Windows Developers) We recommend using uv for package management for faster speed and be
Top issues
#1289Add Linux Packages (AppImage / tar.gz)3 comments · 2026-11-10#1224重配音场景下非台词部分的人声会被忽略How to handle original non-speech vocals (e.g., gasping, sighing) when merging cloned voiceovers?3 comments · 2026-10-13#1229Hy-MT2 works with single videos but fails in batch mode2 comments · 2026-10-15#1290License clarification: GPL-3.0 LICENSE file vs README "non-commercial project" statement1 comments · 2026-11-10#1251Option to normalize dubbed segments0 comments · 2026-10-30#1241希望 [文稿匹配自动对齐] 能够支持一次处理多个对应的MP3和txt文件0 comments · 2026-10-25#1238Program Installer0 comments · 2026-10-22#1236Hosted Dubbing Layer for pyvideotrans — ৳1,900/mo0 comments · 2026-10-21
Discussions
#1310funasr1 comments · 2026-11-14#1307law1 comments · 2026-11-13#1257Best free local setup for Arabic video dubbing with consistent voices?1 comments · 2026-10-31#1228qwen-mt2 comments · 2026-10-15#1227zijierecognmodel2 comments · 2026-10-15#1185googletranslate1 comments · 2026-08-21#1175AUDIO/VIDEO SYNC PROBLEM1 comments · 2026-08-09#1172fanyiqudao2 comments · 2026-08-04
Latest release
windows-v4.18 v4.18 2026-11-05v4.18 Win10/11 预打包版本下载
MacOS/Linux系统请使用源码部署
1. 安装依赖:
bash
macOS
brew install libsndfile git
brew tap homebrew-ffmpeg/ffmpeg
brew install homebrew-ffmpeg/ffmpeg/ffmpeg
Ubuntu/Debian
sudo apt-get install ffmpeg libsndfile1-dev
3. 安装 uv:
bash
curl -LsSf https://astral.sh/uv/install.sh | sh
4. 克隆并启动:
bash
git clone https://github.com/jianchang512/pyvideotrans.git
cd pyvideotrans
uv sync
uv run sp.py
----
v4.18 完整包下载(2.7G)
- 百度网盘地址: https://pan.baidu.com/s/1a32u2WqH9BXbe7TM0SeK8w?pw