cli-anything-videocaptioner

cli-anything-videocaptioner

AI-powered video captioning tool. Transcribe speech → optimize subtitles → translate → burn into video.

Installation

pip install cli-anything-videocaptioner

Prerequisites:

• Python 3.10-3.12 (videocaptioner 1.4.1 requires >=3.10,<3.13)
• videocaptioner must be installed (pip install videocaptioner)
• FFmpeg required for video synthesis

Usage

Basic Commands

# Show help
cli-anything-videocaptioner

REPL Mode

When invoked without a subcommand, the CLI enters an interactive REPL session:

Command Groups

transcribe — Speech to subtitles

• bijian (default): Free, Chinese & English, no setup
• whisper-api: All languages, requires --whisper-api-key

subtitle — Optimize and translate

• Three steps: Split → Optimize → Translate
• Bing/Google translators are free
• 38 target languages supported (BCP 47 codes)

synthesize — Burn subtitles into video

• Mirrors the stable backend synthesize surface
• Subtitle look is controlled by the subtitle asset/backend version, not extra harness flags
• --review-script checks subtitle/script drift before the final export
• Lower --max-script-diff-ratio when copy accuracy matters more than resilience

process — Full pipeline

review — Consistency check and preview

• Detects subtitle/script drift before a hard-burn
• Can render a single review frame instead of producing a full final video

styles — List style presets

• Reports whether the installed backend exposes preset styling support

config — Manage settings

download — Download online video

JSON Output

All commands support --json for machine-readable output:

Backend Notes

• The upstream backend currently requires Python >=3.10,<3.13; prefer Python 3.12 for matrix runs.
• Advanced synthesize-time style flags are backend-version dependent. Use styles to check whether the installed backend exposes them.
• Compatibility flags such as layout, render_mode, style, style_override, and font_file should be treated as non-stable unless styles and the installed backend confirm they are supported.

Target Languages

BCP 47 codes: zh-Hans zh-Hant en ja ko fr de es ru pt it ar th vi id and 23 more.