AI-powered video captioning — transcribe speech, optimize/translate subtitles, burn into video with beautiful customizable styles (ASS outline or rounded background). Free ASR and translation included.
AI-powered video captioning tool. Transcribe speech → optimize subtitles → translate → burn into video with beautiful styles.
pip install cli-anything-videocaptioner
Prerequisites:
videocaptioner must be installed (pip install videocaptioner)# Show help
cli-anything-videocaptioner --help
# Start interactive REPL mode
cli-anything-videocaptioner
# Transcribe a video (free, no setup)
cli-anything-videocaptioner transcribe video.mp4 --asr bijian
# Translate subtitles (free Bing translator)
cli-anything-videocaptioner subtitle input.srt --translator bing --target-language en
# Full pipeline: transcribe → translate → burn subtitles
cli-anything-videocaptioner process video.mp4 --asr bijian --translator bing --target-language en --subtitle-mode hard
# JSON output (for agent consumption)
cli-anything-videocaptioner --json transcribe video.mp4 --asr bijian
When invoked without a subcommand, the CLI enters an interactive REPL session:
cli-anything-videocaptioner
# Enter commands interactively with tab-completion and history
transcribe <input> [--asr bijian|jianying|whisper-api|whisper-cpp] [--language CODE] [--format srt|ass|txt|json] [-o PATH]
bijian (default): Free, Chinese & English, no setupwhisper-api: All languages, requires --whisper-api-keysubtitle <input.srt> [--translator llm|bing|google] [--target-language CODE] [--layout target-above|source-above|target-only|source-only] [--no-optimize] [--no-translate] [-o PATH]
synthesize <video> -s <subtitle> [--subtitle-mode soft|hard] [--quality ultra|high|medium|low] [--style NAME] [--style-override JSON] [--render-mode ass|rounded] [--font-file PATH] [-o PATH]
--style-override '{"outline_color": "#ff0000"}'process <input> [--asr ...] [--translator ...] [--target-language ...] [--subtitle-mode ...] [--style ...] [--no-optimize] [--no-translate] [--no-synthesize] [-o PATH]
styles
config show
config set <key> <value>
download <URL> [-o DIR]
All commands support --json for machine-readable output:
cli-anything-videocaptioner --json transcribe video.mp4 --asr bijian
# {"output_path": "/path/to/output.srt"}
| Name | Mode | Description |
|---|---|---|
default | ASS | White text, black outline — clean and universal |
anime | ASS | Warm white, orange outline — anime/cartoon style |
vertical | ASS | High bottom margin — for portrait/vertical videos |
rounded | Rounded | Dark text on semi-transparent rounded background |
Customize any field: --style-override '{"font_size": 48, "outline_color": "#ff0000"}'
BCP 47 codes: zh-Hans zh-Hant en ja ko fr de es ru pt it ar th vi id and 23 more.