Video Production

Overview

Quick Decision Tree

What do you need?
│
├── Full course assembly (end-to-end)
│   └── references/workflow.md
│   └── Combines all scripts below
│
├── Download videos from Drive
│   └── Script: scripts/gdrive_video_download.py
│
├── Create title slides
│   └── Script: scripts/create_title_slides.py
│
├── Stitch videos together
│   └── Script: scripts/stitch_videos.py
│
└── Generate YouTube description
    └── Script: scripts/generate_youtube_description.py

Environment Setup

System Requirements

• FFmpeg installed and in PATH
• Python 3.9+

Complete Workflow

# Full course assembly from Drive folder
python scripts/stitch_videos.py \
  --folder "https://drive.google.com/drive/folders/xxx" \
  --output "Complete Course.mp4" \
  --slide-duration 3

Pipeline Steps

1. Download - Get all videos from Drive folder
2. Parse Titles - Extract clean names from

   [e1] Intro

   format
3. Get Metadata - FFprobe for duration/resolution
4. Generate Slides - Title card for each lesson
5. Build Concat List - video1 → slide2 → video2 → ...
6. Stitch with FFmpeg - Concatenate all segments
7. Calculate Timestamps - Track cumulative duration
8. Generate Description - YouTube-ready markdown

Outputs

{output_name}.mp4

youtube_description.md

metadata.json

Performance

Security Notes

Credential Handling

• Google OAuth credentials for Drive access (see google-workspace skill)

• mycreds.txt

  and

  client_secrets.json

  never committed to git
• No additional API keys required for local video processing

Data Privacy

• All video processing happens locally using FFmpeg
• No video content is uploaded to external cloud services
• Source videos downloaded from Google Drive to local

  .tmp/

• Final videos stored locally until manually uploaded
• Metadata JSON contains file names and timestamps only

Access Scopes

• Google Drive:

  drive.readonly

  sufficient for downloading
• Google Drive:

  drive

  required for uploading final videos
• No external video processing APIs used

Compliance Considerations

• Local Processing: All encoding/stitching done locally (privacy-preserving)
• No Cloud Upload: Videos never leave your machine during processing
• Content Rights: Ensure you have rights to source video content
• Course Content: Verify licensing for educational content distribution
• YouTube ToS: Generated descriptions comply with YouTube guidelines
• Storage: Large video files require adequate local disk space
• Cleanup: Remove temporary files from

  .tmp/

  after processing

Troubleshooting

Common Issues

Issue: FFmpeg not found

• Install FFmpeg:

  brew install ffmpeg

  (macOS) or download from ffmpeg.org
• Verify installation:

  ffmpeg -version

• Add FFmpeg to PATH if installed in non-standard location
• Restart terminal after installation

Issue: Codec mismatch / incompatible videos

• Re-encode all source videos to the same format before stitching
• Use FFmpeg to normalize:

  ffmpeg -i input.mp4 -c:v libx264 -c:a aac output.mp4

• Ensure consistent resolution (e.g., all 1920x1080)
• Match frame rates across all videos (e.g., all 30fps)

Issue: Audio out of sync

• Use constant frame rate for all source videos
• Re-encode with

  -vsync cfr

  flag
• Avoid mixing video from different sources/devices
• Check audio sample rates match across files

Issue: Insufficient disk space

• Check available disk space:

  df -h

• Clear

  .tmp/

  directory of old files
• Move large source videos to external drive
• Process fewer videos at once

Issue: Google Drive download fails

• Verify Google OAuth credentials (see google-workspace skill)
• Check folder sharing permissions
• Try downloading single file first to test
• Check for network connectivity issues

Issue: Title slides not generating

• Verify ImageMagick or Pillow is installed
• Check font files exist if custom fonts specified
• Review title text for special characters
• Try with default font settings first

Resources

• references/workflow.md - Complete video course workflow

Integration Patterns

Full Course Pipeline

1. Download lesson videos from Google Drive folder
2. Generate title slides and stitch all videos together
3. Upload final video back to Drive and generate YouTube description

Transcript to Timestamps

1. Search transcripts for relevant meetings
2. Extract topic timestamps from transcript
3. Generate formatted YouTube description with chapter markers

Content to Title Slides

1. Generate title slide images with content-generation
2. Export slides in video-compatible format
3. Insert title slides between video segments