TikTok Clipper — Video → Viral Clips with Subtitles

What it does

When to use

• User sends a video and wants TikTok/Reels clips
• User asks to "clip this", "find viral moments", "cut for TikTok"
• User wants subtitles added to video clips

Pipeline

Step 1: Transcribe

# Transcribe with Whisper (word-level timestamps)
python3 SKILL_DIR/transcribe.py --input VIDEO_PATH --output TRANSCRIPT.json

Step 2: Analyze & Suggest Clips

• Hooks: Strong opening lines, provocative statements, questions
• Value bombs: Key insights, surprising facts, actionable tips
• Emotional peaks: Enthusiasm, humor, strong opinions
• Story arcs: Complete mini-stories with beginning/middle/end
• Controversy/debate: Polarizing takes that drive comments

• Time range (start → end)
• Duration
• Hook line (first sentence)
• Why it could be viral
• Suggested caption

Step 3: Cut clips

python3 SKILL_DIR/clip.py --input VIDEO_PATH --start MM:SS --end MM:SS --output CLIP.mp4

• Uses ffmpeg with re-encoding for clean cuts
• Converts to 9:16 vertical if needed (crop or pad)
• Ensures TikTok-compatible format (h264, aac, mp4)

Step 4: Add TikTok-style subtitles

python3 SKILL_DIR/subtitles.py --input CLIP.mp4 --transcript TRANSCRIPT.json --start SS --end SS --style STYLE --output FINAL.mp4

#### Subtitle Styles Available:

• bold-center: White bold text, black outline, centered bottom third (classic TikTok)
• word-highlight: Word-by-word highlight in yellow/green (like CapCut auto-captions)
• karaoke: Current word scales up + color change (Alex Hormozi style)
• box: Text with colored background box (MrBeast style)

Step 5: Vertical format

• Center crop for talking head
• Or blur-background padding (video small in center, blurred fill)

File outputs

Requirements

• ffmpeg (installed)
• OpenAI API key for Whisper (in .env)
• Source video file

Notes

• Max TikTok length: 90 seconds for best performance
• Sweet spot: 30-60 seconds
• Always start with a hook (first 3 seconds matter most)
• Subtitles should be max 2 lines, ~5-7 words per line