video-caption-generator

1name: video-caption-generator
2description: >
3  Transcribe short videos from a Google Drive folder, deduplicate by content,
4  and generate social captions + YouTube/Facebook titles. Use when new video
5  clips are dropped into a Drive folder and you need transcript, caption, and
6  title for each unique clip.
7  Trigger phrases: "process videos in drive", "transcribe new clips",
8  "caption these videos", "generate titles for these clips".
9---
10 
11# Video Caption Generator
12 
13Processes new MP4s from a Google Drive folder: transcribes, deduplicates, generates captions + titles.
14 
15## Drive Folder Setup
16 
17Configure your Google Drive folder IDs before first use:
18 
19| Folder | Purpose |
20|--------|---------|
21| Main / To Schedule | New clips are dropped here for processing |
22| Scheduled | Already posted/scheduled clips (moved after publishing) |
23| A/B | Title variants for later posting |
24 
25Set your folder IDs in `folder-map.json` or pass them directly via `--folder-id`.
26 
27## Quick Run
28 
29```bash
30python3 skills/video-caption-generator/scripts/process_videos.py \
31  --folder-id YOUR_FOLDER_ID
32```
33 
34Processed video IDs are logged to `processed_ids.json` so already-seen videos are skipped on future runs.
35 
36## A/B Variant Handling
37 
38Videos 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.
39 
40## Output Format
41…