Agent skill

cli-anything-videocaptioner

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.

View SKILL.md on GitHub Repository
Stars 30,283
Forks 2,902

Install this agent skill to your Project

npx add-skill https://github.com/HKUDS/CLI-Anything/tree/main/videocaptioner/agent-harness/cli_anything/videocaptioner/skills

SKILL.md

cli-anything-videocaptioner

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

Installation

bash
pip install cli-anything-videocaptioner

Prerequisites:

  • Python 3.10+
  • videocaptioner must be installed (pip install videocaptioner)
  • FFmpeg required for video synthesis

Usage

Basic Commands

bash
# 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

REPL Mode

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

bash
cli-anything-videocaptioner
# Enter commands interactively with tab-completion and history

Command Groups

transcribe — Speech to subtitles

transcribe <input> [--asr bijian|jianying|whisper-api|whisper-cpp] [--language CODE] [--format srt|ass|txt|json] [-o PATH]
  • bijian (default): Free, Chinese & English, no setup
  • whisper-api: All languages, requires --whisper-api-key

subtitle — Optimize and translate

subtitle <input.srt> [--translator llm|bing|google] [--target-language CODE] [--layout target-above|source-above|target-only|source-only] [--no-optimize] [--no-translate] [-o PATH]
  • Three steps: Split → Optimize → Translate
  • Bing/Google translators are free
  • 38 target languages supported (BCP 47 codes)

synthesize — Burn subtitles into video

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]
  • ASS mode: Outline/shadow style with presets (default, anime, vertical)
  • Rounded mode: Modern rounded background boxes
  • Customizable via --style-override '{"outline_color": "#ff0000"}'

process — Full pipeline

process <input> [--asr ...] [--translator ...] [--target-language ...] [--subtitle-mode ...] [--style ...] [--no-optimize] [--no-translate] [--no-synthesize] [-o PATH]

styles — List style presets

styles

config — Manage settings

config show
config set <key> <value>

download — Download online video

download <URL> [-o DIR]

JSON Output

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

bash
cli-anything-videocaptioner --json transcribe video.mp4 --asr bijian
# {"output_path": "/path/to/output.srt"}

Style Presets

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"}'

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.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

HKUDS/CLI-Anything

cli-anything-sts2

Command-line interface for Slay the Spire 2 - Control the real game through a local bridge mod HTTP API. Reads normalized game state and sends action commands for combat, navigation, rewards, and menu management.

30,283 2,902
Explore
HKUDS/CLI-Anything

musescore

CLI for music notation — transpose, export PDF/audio/MIDI, extract parts, manage instruments

30,283 2,902
Explore
HKUDS/CLI-Anything

cli-anything-openscreen

Command-line interface for Openscreen — a screen recording editor. A stateful CLI for editing screen recordings with zoom, speed ramps, trim, crop, annotations, and polished exports. Built on the Openscreen JSON project format with ffmpeg as the rendering backend. Designed for AI agents and power users who need programmatic video editing.

30,283 2,902
Explore
HKUDS/CLI-Anything

cli-anything-adguardhome

Command-line interface for AdGuard Home - Network-wide ad blocking and DNS management via AdGuard Home REST API. Designed for AI agents and power users who need to manage filtering, DNS rewrites, clients, DHCP, and query logs without a GUI.

30,283 2,902
Explore
HKUDS/CLI-Anything

cli-anything-intelwatch

Zero friction. Full context. Competitive intelligence, M&A due diligence, and OSINT directly from your terminal. Uses Node.js/npx.

30,283 2,902
Explore
HKUDS/CLI-Anything

cli-anything-kdenlive

Command-line interface for Kdenlive - A stateful command-line interface for video editing, following the same patterns as the Blender CLI ...

30,283 2,902
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results