Ivx Ams Video Caption Generator

Cursor install notes

• Skill root: this folder (scripts + references live here).
• Vendor source: ~/.cursor/skills/_vendor/ai-marketing-skills/ (git pull to update).
• Telemetry is optional; skip telemetry/*.py unless you opt in.
• Run Python from this skill directory so relative paths resolve.
• Prefer python on Windows if python3 is missing.

Video Caption Generator

Working directory

cd ~/.cursor/skills/ams-video-caption-generator
# Windows: cd $env:USERPROFILE\.cursor\skills\ams-video-caption-generator

Processes new MP4s from a Google Drive folder: transcribes, deduplicates, generates captions + titles.

Drive Folder Setup

Configure your Google Drive folder IDs before first use:

Set your folder IDs in folder-map.json or pass them directly via --folder-id.

Quick Run

python3 skills/video-caption-generator/scripts/process_videos.py \
  --folder-id YOUR_FOLDER_ID

Processed video IDs are logged to processed_ids.json so already-seen videos are skipped on future runs.

A/B Variant Handling

Videos with identical transcripts but different filenames (e.g., 0411.mp4, 0411(1).mp4) are A/B title variants — same audio, different on-screen title. The script processes ALL variants (no dedup skipping) and tags them as A/B variants in the output.

Output Format

For each unique new clip, output:

*<filename>*
📝 *Transcript:* <raw spoken words>
🎬 *Caption:* <social-friendly 2-4 sentence caption>
📺 *YT/FB Title:* <punchy title under 60 chars>

Caption + Title Style Guide

• Caption: First person, conversational, no hashtags, 2-4 sentences. Hook first, insight second.
• Title: Curiosity-driven, under 60 chars, no "How I..." unless earned. Lead with the tension or number.

Dependencies

• whisper (local installation, model: turbo)
• Google Drive CLI or SDK for listing/downloading files
• Anthropic API key (set via ANTHROPIC_API_KEY environment variable)

Configuration

1. Set ANTHROPIC_API_KEY in your environment
2. Update GWS_GATEWAY in scripts/process_videos.py to point to your Google Drive CLI
3. Update WHISPER_BIN if Whisper is installed at a different path

Adding New Folders

Pass --folder-id <ID> for different folders. Each folder uses the same shared processed_ids.json log (Drive IDs are globally unique so there's no collision).