whatisgithub

What is xiaohu-video-translate?

xiaohuailabs/xiaohu-video-translate — explained in plain English

Analysis updated 2026-05-18

495PythonAudience · vibe coderLicense

In one sentence

AI coding agent skills that auto-download, transcribe, translate, and burn Chinese subtitles onto foreign-language videos.

Mindmap

mindmap
  root((xiaohu-video-translate))
    What it does
      Downloads foreign videos
      Transcribes with Whisper
      Translates to Chinese
      Burns in subtitles
    Tech stack
      Python
      Whisper
      yt-dlp
      ffmpeg
    Three skills
      video-md orchestrator
      subtitle-polish
      video-download
    Platforms
      macOS Apple Silicon
      Windows via WSL
      Linux
    Audience
      Vibe coders
      AI CLI users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Turn a YouTube video in any language into a video with burned-in Chinese subtitles using one plain-language request.

USE CASE 2

Generate a clean Chinese transcript from a foreign-language talk without adding subtitles to the video.

USE CASE 3

Add Chinese subtitles to a local video file already saved on your computer.

USE CASE 4

Produce bilingual Chinese and English subtitles for language learning.

What is it built with?

PythonWhisperyt-dlpffmpeg

How does it compare?

xiaohuailabs/xiaohu-video-translatejoeseesun/qiaomu-goal-meta-skillpatchfighterway90/cs2-external-overlay
Stars495494494
LanguagePythonPythonPython
Setup difficultyeasyeasy
Complexity2/52/5
Audiencevibe codervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

So what is it?

This project automatically adds Chinese subtitles to foreign-language videos. With a single plain-language request, it downloads a video, transcribes the speech, translates it into Chinese, cleans up the result, and burns the subtitles into the video. It also produces a clean written transcript. Everything runs on your own computer, and the transcription step costs nothing in service fees. The whole process is a five-step pipeline that runs by itself: download the video, extract the audio and transcribe it, translate it, polish the wording, and finally burn the subtitles onto the video. You just describe what you want, and it walks through each step. Any language that the transcription engine can understand, such as English, Japanese, Korean, French, or Spanish, can be turned into Chinese subtitles. Chinese videos are only transcribed, not translated. Subtitles can be Chinese only or Chinese and English together. Technically, the project is a set of three skills, meaning script-and-instruction bundles that AI coding command-line tools can run. The skills are not tied to one tool: Claude Code, OpenClaw, Gemini CLI, and Codex can all drive them. One skill acts as the overall coordinator, one handles subtitle translation and polishing, and one is a pure downloader. The three can be used together or separately. Transcription uses Whisper, an open speech-recognition system, with extra speed on Apple Silicon Macs. The translation step reuses whatever AI you already have, so you do not need to pay for a separate translation service. The author stresses accuracy: word-level timing so subtitles do not run ahead of the speaker, automatic correction of misheard technical terms, and sentence breaks based on meaning. Installation differs by operating system. On macOS you install a couple of base tools, a Whisper engine, then clone the repository and run an install script. On Windows and Linux there are specific differences, especially the need to switch the subtitle font to one that supports Chinese, since the default is a Mac-only font. After setup you restart your AI coding tool and speak naturally to it. The README also covers common problems, such as download errors and missing fonts, and warns against committing your personal configuration. It is released under the MIT License.

Copy-paste prompts

Prompt 1
Install the xiaohu-video-translate skills into Claude Code and set up the config file.
Prompt 2
Translate this video link into a Chinese-subtitled video with the download and burn-in pipeline.
Prompt 3
Explain how the word-level timestamp alignment keeps subtitles synced with the speaker.
Prompt 4
Help me fix the Chinese subtitle font showing as boxes on Windows.

Frequently asked questions

What is xiaohu-video-translate?

AI coding agent skills that auto-download, transcribe, translate, and burn Chinese subtitles onto foreign-language videos.

What language is xiaohu-video-translate written in?

Mainly Python. The stack also includes Python, Whisper, yt-dlp.

Who is xiaohu-video-translate for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.