Communitygithub.com

HKUDS/CLI-Anything

AI 기반 동영상 자막 도구 — 음성 텍스트 변환, 자막 최적화/번역, 동영상에 자막을 입히는 작업을 안정적인 VideoCaptioner 백엔드로 수행합니다. 무료 ASR 및 번역을 포함합니다.

CLI-Anything란 무엇인가요?

이 스킬은 Claude Code, Cursor, Codex와 같은 AI 에이전트가 동영상 콘텐츠의 자막을 완전히 자동화할 수 있도록 설계된 CLI 도구입니다. 음성을 텍스트로 변환(ASR)하고, 자막을 최적화하며, 38개 언어로 번역한 뒤 최종 동영상에 하드 또는 소프트 자막으로 입힙니다. 무료로 사용할 수 있는 bijian ASR과 Bing/Google 번역기를 기본 제공하여 추가 API 키 없이도 즉시 사용 가능합니다. Python 3.10–3.12 환경에서 `pip install cli-anything-videocaptioner`로 설치하며, FFmpeg가 필요합니다. `transcribe`, `subtitle`, `synthesize`, `process` 등 다양한 명령어 그룹을 제공하며, `--json` 플래그로 AI 에이전트가 파싱하기 쉬운 JSON 출력을 지원합니다. 또한 REPL 모드, 자막/대본 일관성 검토(review), 사전 설정 스타일 조회(styles) 등의 고급 기능을 갖추고 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/HKUDS/CLI-Anything/tree/HEAD/videocaptioner/agent-harness/cli_anything/videocaptioner/skills

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

cli-anything-videocaptioner

AI 기반 동영상 자막 도구입니다. 음성 텍스트 변환 → 자막 최적화 → 번역 → 동영상에 자막 입히기를 수행합니다.

설치

pip install cli-anything-videocaptioner

전제 조건:

  • Python 3.10-3.12 (videocaptioner 1.4.1은 >=3.10,<3.13 필요)
  • videocaptioner가 설치되어 있어야 합니다 (pip install videocaptioner)
  • 동영상 합성을 위해 FFmpeg 필요

사용법

기본 명령어

# 도움말 보기
cli-anything-videocaptioner --help

# 대화형 REPL 모드 시작
cli-anything-videocaptioner

# 동영상 텍스트 변환 (무료, 설정 불필요)
cli-anything-videocaptioner transcribe video.mp4 --asr bijian

# 자막 번역 (무료 Bing 번역기)
cli-anything-videocaptioner subtitle input.srt --translator bing --target-language en

# 전체 파이프라인: 텍스트 변환 → 번역 → 자막 입히기
cli-anything-videocaptioner process video.mp4 --asr bijian --translator bing --target-language en --subtitle-mode hard

# 최종 하드-번 전에 자막/대본 일관성 검토
cli-anything-videocaptioner synthesize video.mp4 -s subtitles.srt \
  --subtitle-mode hard \
  --review-script approved_script.txt

# 검토용 1프레임 자막 미리보기 렌더링
cli-anything-videocaptioner review subtitles.srt \
  --script approved_script.txt \
  --preview-video video.mp4 \
  --preview-output review_5s.png

# JSON 출력 (에이전트 소비용)
cli-anything-videocaptioner --json transcribe video.mp4 --asr bijian

REPL 모드

하위 명령어 없이 실행하면 대화형 REPL 세션이 시작됩니다:

cli-anything-videocaptioner
# 탭 완성 및 히스토리 지원으로 명령어를 대화형으로 입력

명령어 그룹

transcribe — 음성을 자막으로

transcribe <input> [--asr bijian|jianying|whisper-api|whisper-cpp] [--language CODE] [--format srt|ass|txt|json] [-o PATH]
  • bijian (기본값): 무료, 중국어 및 영어, 설정 불필요
  • whisper-api: 모든 언어, --whisper-api-key 필요

subtitle — 자막 최적화 및 번역

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]
  • 세 단계: 분할 → 최적화 → 번역
  • Bing/Google 번역기는 무료
  • 38개 대상 언어 지원 (BCP 47 코드)

synthesize — 동영상에 자막 입히기

synthesize <video> -s <subtitle> [--subtitle-mode soft|hard] [--quality ultra|high|medium|low] [-o PATH] [--review-script PATH] [--max-script-diff-ratio FLOAT]
  • 안정적인 백엔드 합성 표면을 그대로 반영
  • 자락 모양은 추가 하네스 플래그가 아닌 자막 에셋/백엔드 버전에 의해 제어됨
  • --review-script는 최종 내보내기 전에 자막/대본 불일치를 확인
  • 복사 정확도가 복원력보다 중요할 때는 --max-script-diff-ratio를 낮춤

process — 전체 파이프라인

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

review — 일관성 검사 및 미리보기

review <input.srt|input.ass> [--script PATH] [--max-diff-ratio FLOAT] [--preview-video PATH] [--preview-at TC] [--preview-output PATH]
  • 하드-번 전에 자막/대본 불일치 감지
  • 전체 최종 동영상 대신 단일 검토 프레임을 렌더링 가능

styles — 스타일 프리셋 목록

styles
  • 설치된 백엔드가 사전 설정 스타일 지원을 노출하는지 보고

config — 설정 관리

config show
config set <key> <value>

download — 온라인 동영상 다운로드

download <URL> [-o DIR]

JSON 출력

모든 명령어는 기계 판독 가능한 출력을 위해 --json을 지원합니다:

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

백엔드 참고 사항

  • 업스트림 백엔드는 현재 Python >=3.10,<3.13이 필요합니다. 매트릭스 실행 시 Python 3.12를 선호합니다.
  • 고급 합성 시간 스타일 플래그는 백엔드 버전에 따라 다릅니다. styles를 사용하여 설치된 백엔드가 해당 플래그를 노출하는지 확인하세요.
  • layout, render_mode, style, style_override, font_file 같은 호환성 플래그는 styles와 설치된 백엔드가 지원을 확인하지 않는 한 비안정적인 것으로 간주해야 합니다.

대상 언어

BCP 47 코드: zh-Hans zh-Hant en ja ko fr de es ru pt it ar th vi id 및 23개 추가 언어.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

cli-anything-adguardhome

>-

cli-anything-anygen

>-

cli-anything-audacity

>-

cli-anything-blender

>-

cli-anything-browser

Browser automation CLI using DOMShell MCP server. Maps Chrome

cli-anything-calibre

>-

cli-anything-ccswitch

CLI interface for CC Switch — manage AI coding tool configurations from the terminal

cli-anything-chromadb

>-

cli-anything-cloudanalyzer

Command-line interface for CloudAnalyzer — Agent-friendly harness for CloudAnalyzer, a QA platform for mapping, localization, and perception outputs. Supports 27 commands across 8 groups: point cloud evaluation, trajectory evaluation, ground segmentation QA, config-driven quality gates, baseline evolution, processing, visualization, and interactive REPL.

cli-anything-cloudcompare

Command-line interface for CloudCompare — Agent-friendly harness for CloudCompare, the open-source 3D point cloud and mesh processing software. Supports 41 commands across 9 groups: project management, session control, point cloud operations (subsample, filter, segment, analyze), mesh operations, distance computation (C2C, C2M), transformations (ICP, matrix), export (LAS/LAZ/PLY/PCD/OBJ/STL/E57), and interactive REPL.

cli-anything-comfyui

>-

cli-anything-dify-workflow

Wrapper for the Dify workflow DSL CLI. Create, inspect, validate, edit, and export Dify workflow files through a CLI-Anything harness.

cli-anything-drawio

>-

cli-anything-eez-studio

Use EEZ Studio from the command line: inspect and modify native .eez-project files, edit LVGL screens/widgets, manage SCPI commands, and invoke the real EEZ Studio backend for LVGL builds.

cli-anything-eth2-quickstart

>-

cli-anything-exa

>-

cli-anything-firefly-iii

Firefly III CLI - Personal finance management via CLI-Anything

cli-anything-freecad

Complete CLI harness for FreeCAD parametric 3D CAD modeler (258 commands). Covers ALL workbenches: Part (29 primitives + boolean + mirror + loft + sweep), Sketcher (26 cmds: geometry + constraints + editing), PartDesign (38 cmds: pad/pocket/groove/fillet/chamfer/patterns/hole/datum), Assembly (11 cmds), Mesh (16 cmds), TechDraw (15 cmds: views + dimensions + PDF/SVG), Draft (33 cmds: 2D shapes + arrays + transforms), FEM (12 cmds), CAM/CNC (10 cmds), Surface (6 cmds), Spreadsheet (7 cmds), Import (13 formats), Export (17 formats), Measure (12 cmds), Materials (21 presets). Headless FreeCAD export to STEP/IGES/STL/OBJ/DXF/PDF/glTF/3MF.

cli-anything-gimp

>-

cli-anything-godot

>-

관련 스킬