Open-source video translation

Turn video into bilingual subtitles.

A resumable command-line workflow for transcription, translation, subtitle export, and hard-subtitle burning.

Getting started View on GitHub
Install with uv
uv tool install 'openbbq[whispercpp]'
Workflow
  1. openbbq init --workspace workspaces/demo ./video.mp4
  2. openbbq transcribe --workspace workspaces/demo
  3. openbbq segment --workspace workspaces/demo
  4. openbbq translate init --workspace workspaces/demo --target-language zh
  5. openbbq export --workspace workspaces/demo --target-language zh --format ass
Workspace output
  • manifest.json
  • media/audio.16k.wav
  • transcript.json
  • cues.json
  • translation.zh.json
  • out/zh.ass

Inspectable by default

Each stage leaves an artifact you can review.

CLI reference

Source

Fetch a URL or use a local video.

media/audio.16k.wav

Transcribe

Create a timed source transcript.

transcript.json

Translate

Review an editable target worksheet.

translation.zh.json

Export

Write subtitles or a burned video.

out/zh.ass

Built for agents and people

Automate the routine. Keep every artifact editable.

Commands are composable, progress is recorded in the workspace, and interrupted stages can be resumed without hiding the intermediate files.

See the workflow model