| --- |
| license: mit |
| language: |
| - en |
| - my |
| tags: |
| - burmese |
| - myanmar |
| - video-dubbing |
| - dubbing |
| - text-to-speech |
| - faster-whisper |
| - flask |
| - edge-tts |
| - gemini |
| --- |
| |
| # DubLab — English ↔ Burmese Video Dubbing |
|
|
| **Upload a short video, get it back dubbed in the other language.** |
|
|
| DubLab is a self-hosted web app that dubs short videos between **English and |
| Burmese (Myanmar)**. It transcribes the speech (faster-whisper, local), |
| translates it (Gemini API), synthesizes a new voice track (Nara Mini local |
| ONNX voices Shoon + Ko Banyar by default, Edge-TTS / Gemini TTS as options), |
| syncs it to the picture, and returns a finished MP4. |
|
|
| 🌐 **Live demo:** https://dublab.kbko.qzz.io |
| 📄 **License:** MIT — Source: https://github.com/khantbhoneko36-commits/dublab |
|
|
| ## Features |
|
|
| - 🎬 **Video dubbing** — upload a video (≤ 10 min, ≤ 250 MB) or paste a link |
| (YouTube, TikTok, Instagram, Facebook, X, Vimeo, Bilibili…), download the dubbed MP4 |
| - 🗣️ **Burmese + English voices** — Nara Mini local voices, free, no API key |
| - 🎙️ **Local transcription** — faster-whisper on your own machine |
| - 🌏 **Translation** — Gemini API (free tier works), with NLLB local fallback |
| - ⏱️ **Sync engine that never cuts a sentence** — speech is time-fitted up to a |
| capped speed-up (1.65×); overflow cascades into the next slot |
| - 💧 **Credit watermark** — small lower-right watermark (configurable text) |
| - 🛡️ **Abuse protection built in** — job queue cap, per-IP upload rate limit, |
| 24 h result retention |
|
|
| ## Quick start |
|
|
| Requirements: Python 3.11+, `ffmpeg`, and a free |
| [Gemini API key](https://aistudio.google.com/apikey). |
|
|
| ```bash |
| git clone https://github.com/khantbhoneko36-commits/dublab.git |
| cd dublab |
| python3 -m venv venv && source venv/bin/activate |
| pip install -r requirements.txt |
| cp .env.example .env # put your GEMINI_API_KEY in .env |
| set -a; source .env; set +a |
| waitress-serve --listen=127.0.0.1:8092 --threads=8 app:app |
| ``` |
|
|
| Open http://127.0.0.1:8092, drop in a short video, pick a direction and a |
| voice, and download the dubbed result. |
|
|
| ### Docker |
|
|
| ```bash |
| docker build -t dublab . |
| docker run -d --name dublab -p 127.0.0.1:8092:8092 --env-file .env dublab |
| ``` |
|
|
| > ⚠️ Dependency pins matter: `requirements.txt` pins `av==15.1.0` and |
| > `huggingface_hub<1` — newer versions break faster-whisper 1.2.x. The Nara |
| > Mini voices (Shoon + Ko Banyar) are downloaded at Docker build time from |
| > `YeeNyunn/nara-mini-v1` on the Hub. |
| |
| ## Configuration |
| |
| | Variable | Required | Purpose | |
| |---|---|---| |
| | `GEMINI_API_KEY` | ✅ | Translation (and TTS fallback if no TTS keys set) | |
| | `GEMINI_TTS_API_KEYS` | — | Comma-separated keys for Gemini TTS rotation | |
| | `DUBLAB_ADMIN_KEY` | — | Password for the `/admin` reviews page | |
|
|
| ## မြန်မာဘာသာ အကျဉ်းချုပ် |
|
|
| DubLab ဆိုတာ ဗီဒီယိုအတိုတွေကို **အင်္ဂလိပ် ↔ မြန်မာ** အပြန်အလှန် |
| အသံသွင်း (dub) လုပ်ပေးတဲ့ open-source web app တစ်ခုပါ။ ဗီဒီယိုတင်လိုက်ရင် |
| စကားပြောကို စာသားအဖြစ်ပြောင်း၊ ဘာသာပြန်၊ မြန်မာအသံ (ကျား/မ) နဲ့ |
| အသံအသစ်ဖော်ပြီး၊ စာကြောင်းမပြတ်အောင် အချိန်ကိုက် ညှိပေးကာ |
| dub လုပ်ပြီးသား MP4 ပြန်ချပေးပါတယ်။ |
|
|
| ## Maintainer |
|
|
| Built and maintained by **Khant Bhone Ko** — |
| sole maintainer: releases, issue triage, and the production deployment. |
| More projects: https://pro.kxant.org |
|
|
