jianchang512/pyvideotrans

Project overview

A one-click video translation and audio transcription tool that handles speech recognition, subtitle translation, multi-role AI dubbing, and video synthesis. It supports both local offline deployment and various online APIs.

Project type

Workflow · Video · Audio & Speech

Use cases

Meeting Notes · Translation & Subtitles · Video Creation · Audio & Speech

Deployment

Refer to project documentation

License

GPL-3.0

Best for

• Creators and general users who need an all-in-one desktop application for translating videos and generating subtitles without requiring coding skills.
• Users who require flexible data boundary options, including fully local offline translation using models like Ollama or optional online API integrations.
• Developers needing a command line interface for headless operation and batch processing of audio/video transcription or text-to-speech tasks.

Key capabilities

• Executes a one-click workflow: Speech Recognition (ASR) followed by Subtitle Translation, Speech Synthesis (TTS), and Video Synthesis.
• Batch converts audio or video files to SRT subtitles and supports Speaker Diarization to distinguish between different roles.
• Assigns different AI dubbing voices to different speakers identified in the audio.
• Integrates models such as F5-TTS, CosyVoice, and GPT-SoVITS for zero-shot voice cloning.
• Supports pausing and manual proofreading at each stage—recognition, translation, and dubbing—to verify accuracy.
• Includes auxiliary tools such as vocal separation, video and subtitle merging, audio-video alignment, and transcript matching.
• Supports headless operation for server deployment or batch processing tasks.
• Provides a browser-based interface for remote access or internal network deployment.

Limitations and risks

• The pre-packaged version must be extracted to a path that does not contain Chinese characters or spaces.
• A GPU is optional but recommended for local models. Using external services like OpenAI or Azure for ASR, Translation, or TTS may incur costs.
• Telemetry practices are not documented.

Getting started

• Download the latest pre-packaged version, extract the compressed file to a path without Chinese characters or spaces, and double-click sp.exe.

Evidence and sources

• GitHub project description: Translate the video from one language to another and embed dubbing & subtitles.
• Release: win-pyvideotrans-v4.05
• README: pyVideoTrans is dedicated to seamlessly converting videos from one language to another, offering a complete workflow that includes speech recognition, subtitle translation, multi-…
• README: - **🎙️ Audio Transcription / Subtitle Generation**: Batch convert audio/video to SRT subtitles, supporting **Speaker Diarization** to distinguish between different roles.
• README: We provide a pre-packaged `.exe` version for Windows 10/11 users, requiring no Python environment configuration.

Reviewed at: 2026-07-17T12:39:10Z