AI Video Translate

Installation & user guide · Vietnamese AI Video toolkit
VI EN
100% runs locally — no API key needed macOS (Apple Silicon) Windows 10 / 11 · 64-bit Version 2.0

System requirements

  • macOS: version 11 (Big Sur) or later, Apple Silicon chip (M1/M2/M3/M4).
  • Windows: Windows 10 or 11, 64-bit.
  • Free disk space: about 3–5 GB (for Python, ffmpeg, and the voice models downloaded on first run).
  • Internet: required for the first install (downloading Python/models). After that it works offline (except the online "Studio" voices).
The first install takes a while (~a few minutes) because the machine has to download Python, ffmpeg, and the voice models. Every launch after that opens the app instantly.

Install on macOS

For the AI-Video-Translate-macos-arm64.dmg file — the app is self-contained, no need to install Python or anything else.

macOS Steps
  1. Open the .dmg file
    Double-click the downloaded file — a window appears with the app + the Extension folder + instructions.
  2. Drag AI Video Translate into the Applications folder
    The familiar Mac install flow. When done, you can eject the .dmg.
  3. First launch: right-click the app in Applications → Open → Open
    The app is not code-signed yet, so macOS shows a warning — you only need to do this once. Even easier: double-click Mở lần đầu (gỡ cảnh báo).command right in the .dmg window and it clears the warning for you.
  4. First run: the AI models download automatically (~a few GB)
    Requires internet, downloads only once. After that, open from Launchpad / Applications and you're straight in.
  5. Want to translate YouTube directly?
    Drag the Extension Chrome (dich YouTube) folder from the .dmg window into Documents, then see the Extension section below.
Requires a Mac with an Apple Silicon chip (M1 or later — every Mac since 2020). Everything is bundled inside the app — no Homebrew, no Python needed.

Install on Windows

We recommend the AI-Video-Translate-Setup-windows-x64.exe file — installs like a regular Windows app (Desktop icon, uninstall via Add/Remove Programs).

Windows Option 1 — Setup.exe (recommended)
  1. Open AI-Video-Translate-Setup-windows-x64.exe
    If SmartScreen warns ("Windows protected your PC") → click More info → Run anyway. It installs into your user account — no admin rights needed.
  2. Next → Install → Finish
    Keep the "Install & run now" box ticked at the last step — the app opens automatically to install the rest.
  3. First run: automatically installs Python + ffmpeg + models (~a few minutes, internet required)
    If it just installed Python via winget and prompts you — close the window and reopen from the icon. Once done, the AI Video Translate icon sits on your Desktop + Start Menu.
  4. From then on: double-click the icon to open the app
    Opens straight into the app window, no black console window. To uninstall: Settings → Apps → AI Video Translate → Uninstall.
  5. Want to translate YouTube directly?
    Start Menu → AI Video Translate - Extension YouTube (mở thư mục) (opens the extension folder) → see the Extension section below.
Option 2 — zip archive ai-video-translate-windows-amd64-py3.11.zip (portable, no install needed): right-click → Extract All… → open the folder → double-click Cài đặt và Chạy AI Video Translate.bat. After the first install it also creates a Desktop icon.

3 tools in the app

Translate & Dub

Transcribes the video, translates it into Vietnamese, and dubs it with a natural-sounding voice (voice cloning included).

Clip Cutter & Titles

Automatically cuts long videos into short clips and suggests a catchy title for each one.

Script → Video

Turns a written script into a motion-graphics video (Ainius mode). Needs extra setup — see the section below.

Enable Script → Video (optional)

Translate/Dub & Clip Cutter work right after install. Only Script → Video needs 3 extra steps (it renders with Node and runs a local LLM through Ollama):

  1. Install Node.js
    Download the LTS build at nodejs.org and install it as usual.
  2. Install Ollama
    Download at ollama.com. Then open Terminal/CMD and run: ollama pull qwen2.5:7b (downloads a ~4.7 GB model).
  3. Install the Remotion dependencies
    Open Terminal/CMD, go to the Resources/remotion folder inside the app, then run: npm install (one time only).
If you skip these 3 steps, the Script → Video tab still opens normally — it just shows a setup hint and does not break anything else.

Add cloud AI voices with an API key (optional)

By default the app runs 100% on your machine — no key needed. If you want extra cloud voices, just paste an API key into ⚙️ Settings: enter a key and the voices appear automatically in the voice picker (both in the app and the YouTube extension); remove the key and they disappear. Keys are stored locally on your machine — never sent to AIECOS; any usage fees (if applicable) are billed to your own provider account.

  1. FPT.AI — 9 Vietnamese voices across 3 regional accents (recommended · free 100,000 characters/month)
    Sign up at console.fpt.ai → create a Project → open the Text to Speech service → copy the API key. Important: remember to click Activate on the TTS service in the console — until it's activated, the key returns the error "cannot consume this service". Paste the key into the FPT.AI TTS Key field → 💾 Save settings.
  2. ElevenLabs — 6 premium English voices (great for Vietnamese → English dubbing)
    Create an account at elevenlabs.io → bottom-left menu → API Keys → create a key with full permissions → paste it into the ElevenLabs API Key field. The Free plan gives ~10,000 characters/month and cannot be used for commercial videos. On a paid plan (Starter or higher) you can also enable voice cloning via ElevenLabs under Voice clone (source).
  3. Groq — ultra-fast cloud speech recognition (ASR, free)
    Get a key at console.groq.com → paste it into the Groq API Key field → switch ASR mode to Cloud · ultra fast. Saves you from downloading the ~4.5 GB local speech model.
  4. OpenAI — high-accuracy speech recognition (paid)
    Get a key at platform.openai.com → paste it into the OpenAI API Key field → set ASR mode to Cloud · high accuracy.
The common flow: open the app → ⚙️ Settings → paste the key → 💾 Save settings → go back to the Translate tab; the new voices show up immediately under Voice — no restart needed. Keys live in a local settings file on your machine; change or remove them anytime.

YouTube translation extension (bundled in the package)

The package includes the Extension Chrome (dich YouTube) folder — translate & dub YouTube videos right while you watch. Subtitles are free; dubbing requires a license. One-time setup (~1 minute):

  1. Open the extensions page
    Open Google Chrome → type chrome://extensions in the address bar → Enter.
  2. Turn on Developer mode
    Flip the Developer mode switch in the top-right corner.
  3. Load the unpacked extension
    Click Load unpacked → select the Extension Chrome (dich YouTube) folder. Where is that folder? Mac (.dmg): drag it from the .dmg window into Documents first (the dmg is read-only). Windows (Setup.exe): Start Menu → "AI Video Translate - Extension YouTube (mở thư mục)". Windows (zip): it sits next to the installer.
  4. Use it right away
    Open the app (keep it running in the background) → open a YouTube video → click the extension icon → turn on Vietnamese subtitles (or Dubbing if you have a license).
The app must be running for the extension to connect (local bridge at 127.0.0.1:7861). Keep the extension folder where it is — don't delete it; Chrome reads directly from it.

What's inside the package

You only need to care about the app + the Extension folder. All technical files are tucked away — no need to touch them.

💿 The .dmg window (macOS) ├─ 📱 AI Video Translate.app ← drag into Applications ├─ 🔓 Mở lần đầu (gỡ cảnh báo).command ← clears the Gatekeeper warning (once) ├─ 🧩 Extension Chrome (dich YouTube)/ ← drag into Documents, then load into Chrome └─ 📄 README - Cài đặt.txt · Cách cài Extension YouTube.txt 🪟 Windows after running Setup.exe ├─ 🖥️ "AI Video Translate" icon ← Desktop + Start Menu — launch the app here ├─ 🧩 Start Menu: "Extension YouTube (mở thư mục)" + "Hướng dẫn Extension" ├─ 🗑️ Settings → Apps → Uninstall ← removes the app completely (models included) └─ 📁 App lives in AppData\Programs\AI Video Translate (no need to touch it) 📁 Windows zip build (.zip — portable) ├─ ▶️ Cài đặt và Chạy AI Video Translate.bat ← double-click to install & launch ├─ 🧩 Extension Chrome (dich YouTube)/ ← load into Chrome ├─ 📄 README.txt · Hướng dẫn cài đặt.html · Cách cài Extension YouTube.txt └─ 📁 Resources/ ← modules, installer… (do not modify)

Troubleshooting common issues

SymptomFix
Mac says the app "can't be opened because the developer cannot be verified" Right-click the app → Open → Open (first time only). Or go to System Settings → Privacy & Security → click Open Anyway.
Windows SmartScreen "Windows protected your PC" Click More info → Run anyway. (The app installs locally and sends no data anywhere.)
Python reported missing / winget fails to install Install Python 3.11 manually: on Windows, download it at python.org; on macOS, run brew install python@3.11. Then open the app again.
Install hangs at the "downloading model / ffmpeg" step Usually the network (a few hundred MB to download). Check your connection and launch it again — it resumes the missing parts, no starting over.
App window doesn't open / blank window Quit the app completely and reopen from the icon. Still stuck: open http://127.0.0.1:7880 in your browser (older Windows zip builds: 7860).
"Studio" voices produce no sound The "Studio" voices need internet. When offline, pick Linh or piper (they run locally).
Script → Video tab asks for Node / Ollama Follow the Enable Script → Video section above. The other tools are unaffected.