krillinai-subtitle

KrillinAI Subtitle

Use this skill for the subtitle stage. Read skills/krillinai-cli/references/cli-contract.md first for binary location, execution working directory, configuration, and JSON behavior.

Command

(cd "$KRILLINAI_CWD" && "$KRILLINAI_CLI" subtitle "<input>" \
  --origin-lang en \
  --target-lang zh_cn \
  --workdir "$WORKDIR" \
  --caption-source any \
  --prepare-video)

Inputs

• YouTube URL: prefer --caption-source any; platform captions are used first, then Whisper fallback.
• Local file: use local:/abs/path/video.mp4 or a path accepted by the CLI.
• Bilibili or other yt-dlp supported links: use when media download works; platform caption behavior may differ, so expect transcription fallback.

Important Flags

Flag	Use
--origin-lang	Source language, such as en, zh, ja
--target-lang	Target language, such as zh_cn
--workdir	Dedicated task directory
--caption-source any	Prefer platform captions, fallback to transcription
--caption-source whisper	Force transcription
--prepare-video	Require the original video for later render stages
--bilingual-top=true	Put target language on top in bilingual SRT
--subtitle-style-file	Merge a JSON subtitle-style override
--dry-run	Validate without downloads or AI calls

Outputs

After a real run, read paths from krillinai_manifest.json. Main files:

• origin_language_srt.srt
• target_language_srt.srt
• bilingual_srt.srt
• short_origin_mixed_srt.srt
• origin_video.mp4 when media preparation produced or required video
• origin_audio.mp3 when transcription preparation produced audio

subtitle --dry-run validates command shape but does not write a manifest or output files.

Verification

• Require terminal JSON with "ok": true.
• Confirm krillinai_manifest.json exists under --workdir.
• Spot-check bilingual_srt.srt ordering and short_origin_mixed_srt.srt readability.
• When --prepare-video was requested, require a non-empty origin_video output.
• For Agent integration details, read skills/krillinai-cli/references/cli-contract.md.