LibreAI / Video / pyvideotrans
// video · jianchang512/pyvideotrans

pyvideotrans

Translate videos end to end - speech recognition, translated subtitles and dubbing in one app

★ 19.3k stars⑂ 2.4k forksGPL-3.0updated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

pyvideotrans is an open-source video project by jianchang512 (jianchang512/pyvideotrans on GitHub). It has 19,264 GitHub stars and 2,375 forks, is released under the GPL-3.0 license, and was last updated on GitHub on 7 October 2026.

GitHub stars
19,264
Forks
2,375
License
GPL-3.0
Last updated on GitHub
7 October 2026
Category
Video
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Pick a video and languages

    Choose the source video, its language, and the target language and voice.

  2. Get pyVideoTrans

    Windows users can use the packaged release; developers clone the repo for a source install.

  3. Install dependencies

    Source installs use uv sync after installing prerequisites such as ffmpeg.

  4. Run your first translation

    Launch the app or CLI, run the video translation task, and check the dubbed output.

// features

Why people love it

Full video translation pipeline

Recognizes speech, translates subtitles and generates dubbing, then embeds both in the output video.

Audio-to-subtitle mode

Transcribes audio files to subtitle files with models such as Whisper large-v3.

Subtitle translation mode

Translates existing subtitle files (for example SRT) between languages.

Text-to-speech mode

Turns subtitle files into spoken audio with selectable voices.

GUI, CLI and WebUI

Drive it from the desktop app, scripted CLI tasks, or the optional WebUI.

Many channels and models

Supports a range of speech, translation and TTS services and local models (see the README's channel list).

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source code from GitHub and enter the project directory.

    git clone https://github.com/jianchang512/pyvideotrans.git
    cd pyvideotrans
  2. Clone and install from source

    The source deployment uses uv to create the environment and sync dependencies.

    uv sync
  3. Launch and translate

    Start the GUI, or run a CLI task such as video translation or speech-to-text.

    uv run sp.py
    # CLI: uv run cli.py --task vtv --name "./video.mp4" --source_language_code zh-cn --target_language_code en
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains this project?

It is maintained by jianchang512 and contributors on GitHub.

Is it free to use?

Yes - it is GPL-3.0 licensed and free to use; note GPL copyleft terms if you redistribute it.

Does it need a paid API key?

Local models (such as Whisper) run without keys, but some translation/TTS channels are cloud services that need your own accounts or API keys.

How does it compare to alternatives?

Compared with subtitle-only tools, pyVideoTrans covers the whole chain - recognition, translation and voiced dubbing - in one open-source desktop app.

How do I get started?

On Windows, download the packaged build; from source, clone, run uv sync, then uv run sp.py and open a video.

// keep exploring

Similar tools

Video

VideoLingo

Netflix-level video subtitles and dubbing - a one-click AI subtitle team

★ 18.7k starsApache-2.0
View guide →
Video

bluez-dubbing

Modular end-to-end AI dubbing for video translation.

★ 31 starsApache-2.0
View guide →
Video

GhostCut_Remake_Video

Remix videos: strip subtitles, rewrite captions, AI re-dub.

★ 206 starsCustom
View guide →
Video

sdk

AI video SDK — JSX for videos, one API for Kling, ElevenLabs and Veed.

★ 340 starsApache-2.0
View guide →
Video

perso-dubbing-plugin

Auto-dub videos from your coding agent via the Perso API.

★ 38 starsMIT
View guide →
Video

dub-studio

Offline AI video dubbing for Windows: voice cloning, subtitles, no cloud.

★ 143 starsNOASSERTION
View guide →
// alternatives

Alternatives in Video

The most-starred other Video projects in the LibreAI catalogue — the realistic shortlist if pyvideotrans is not the right fit.

Get pyvideotrans

Free and open — grab the source, star the repo, and start creating.