How to Translate and Dub Videos with VideoLingo: Docker Setup Tutorial
Step-by-step tutorial: deploy VideoLingo with Docker, configure your LLM and TTS providers, and turn any video into translated, aligned, dubbed subtitles from the browser.
In this hands-on tutorial you will deploy VideoLingo with Docker and turn a raw video into translated, subtitle-aligned and dubbed output β all from a web browser. You need a machine with at least 4 GB of RAM (8 GB recommended) and an API key for the LLM of your choice.
π Want to deploy VideoLingo yourself?
Docker configs, system requirements, and installation guides β all on one page.
View VideoLingo Tool Page βStep 1 β Start the container
Pull the community image and run the Streamlit app on port 8080:
docker run -d --name videolingo -p 8080:8080 -v ./videolingo-data:/data rqlove/videolingo:latest
Open http://localhost:8080 and the setup wizard greets you.
Step 2 β Configure providers
Paste your LLM API key (OpenAI, DeepSeek, Gemini or any OpenAI-compatible endpoint) and, optionally, a TTS provider for dubbing. WhisperX transcription runs locally inside the container.
Step 3 β Run the pipeline
- Upload a video or paste a YouTube URL
- Pick source and target languages
- Click Start and watch each stage complete: transcription β segmentation β translation β alignment
- Preview subtitles, fine-tune any line, then export SRT/VTT
π‘ Pro tip: run the translation step first without dubbing to check quality, then enable GPT-SoVITS voice cloning on a second pass β it saves API credits while you tune prompts.
What to expect
In our test run, a 10-minute English video became natural German subtitles in about three minutes, with perfectly aligned sentence-level timestamps. Dubbing added roughly one minute of processing per minute of footage.
| Task | Result |
|---|---|
| Transcription | Accurate, timestamped WhisperX output |
| Translation | Natural, context-aware LLM sentences |
| Dubbing | Voice-cloned audio synced to video |
VideoLingo is one of the simplest self-hosted subtitle pipelines to operate β if you can run a Docker container, you can run an AI localization studio.
π Want to deploy VideoLingo yourself?
Docker configs, system requirements, and installation guides β all on one page.
View VideoLingo Tool Page β