jianchang512 /pyvideotrans

Translate the video from one language to another and embed dubbing & subtitles.

★ 19,753⑂ 2,457👁 104⑃ 226● 980▤ 97
PythonGPL-3.0Created 2023-10-02pyvideotrans.com
下载:windows-v4.18windows-v4.18 ↓4.182026-11-05
+10
日增长
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

Discussions

Latest release

windows-v4.18 v4.18 2026-11-05
v4.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

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