Video Toolkit

Remotion-powered video editing toolkit. Transcribe source footage, plan edits, compose with overlays, render final videos.

Structure

├── src/                    # Remotion compositions & components
│   ├── Root.tsx            # Composition registration
│   ├── index.ts            # registerRoot entry
│   ├── editData.ts         # Clip definitions, task list, timing
│   ├── DayTwoComposition.tsx
│   └── VideoClip.tsx       # Reusable video clip player
├── public/
│   └── audio/              # Sound effects
├── transcribe/             # Python transcription tool (mlx-whisper)
│   ├── transcribe.py       # Transcribes videos → JSON + .txt
│   └── transcripts/        # Generated transcripts
├── videos/                 # Source footage (gitignored)
├── remotion.config.ts
├── package.json
└── tsconfig.json

Workflow

1. Transcribe

# Drop source videos into videos/
bun run transcribe
# Outputs to transcribe/transcripts/

2. Plan edits

Edit src/editData.ts — define clips (source file, start/end timestamps), tasks, and timing.

3. Extract clips

# Extract each planned clip as a small mp4 for fast Remotion rendering
ffmpeg -ss START -i videos/SOURCE.MOV -t DURATION \
  -c:v libx264 -preset ultrafast -crf 22 \
  -c:a aac -b:a 192k -movflags +faststart \
  -y public/clips/clip-name.mp4

4. Preview

bun run dev

5. Render

bun run render DayTwo out/final.mp4 --codec h264 --crf 20

Reusable Components

• VideoClip — Plays a video file from public/
• DayTwoComposition — Full video composition with Series clips, DAY #2 overlay, and terminal-style todo list
• editData.ts — Data-driven clip list and task definitions

Tools

• Remotion — React-based video composition
• FFmpeg — Clip extraction, format conversion
• mlx-whisper — Local transcription on Apple Silicon