Skip to content

examples: short-video narration recipe (silent clip → 9:16 draft with voiceover + captions), en + zh-CN - #124

Merged
renezander030 merged 1 commit into
masterfrom
docs-short-video-narration
Sep 19, 2026
Merged

renezander030 merged 1 commit into
masterfrom
docs-short-video-narration

Conversation

@renezander030

Copy link
Copy Markdown
Owner

What

  • examples/short-video-narration.md and examples/short-video-narration.zh-CN.md: silent clip → 9:16 draft with a TTS voiceover and script-accurate captions, as four existing commands (quickstart --ratio 9:16tts --text-filecaption --from-segment --scriptlint) and as one script.
  • examples/scripts/narrate-short.sh chains the four steps: prints the draft path and the voiceover segment, treats a missing whisper as "captions skipped" rather than a failure, stops with the CLI's own error on anything else. CAPCUT_TTS_CMD swaps the engine.
  • examples/scripts/edge-tts-wav.sh bridges edge-tts (which only writes MP3) to the WAV that tts expects at {out}, via ffmpeg.
  • The vision-model step that writes the narration is optional and stays outside the CLI: the script is a plain text file, one sentence per line.

Why

The most common short-form pipeline in the JianYing ecosystem is footage → narration → captions → app, and every piece of it already existed as a command. This is the recipe that shows them as one path, in the language most of that audience reads first.

Checks

  • Script run end to end against the built CLI with a synthetic clip and a stand-in engine: draft created (1080×1920), voiceover segment added, captions skipped cleanly without whisper, lint clean. Name-omitted form, failing engine and missing edge-tts each exit 1 with the CLI's message.
  • bash -n on both scripts. No source changes; no test suite impact.

Docs

Examples index row + note that this recipe exists in both languages; a pointer from the zh-CN quickstart's "接下来"; CHANGELOG (Unreleased).

…with voiceover and captions

Four commands (quickstart --ratio 9:16, tts --text-file, caption --from-segment
--script, lint) written up in English and Chinese, plus narrate-short.sh that
chains them and edge-tts-wav.sh that bridges edge-tts (MP3 only) to the WAV
tts expects at {out}. The vision-model step that writes the script is optional
and stays outside the CLI: the script is a text file.
@renezander030
renezander030 force-pushed the docs-short-video-narration branch from 2efa7b0 to 0c3b78f Compare September 19, 2026 15:51
@renezander030
renezander030 merged commit dfde2bd into master Sep 19, 2026
9 checks passed
@renezander030
renezander030 deleted the docs-short-video-narration branch September 19, 2026 15:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant