Transcribe audio and video files to text using OpenAI Whisper. Use when: converting podcasts to blog posts; creating video subtitles; extracting quotes from interviews; repurposing video content to text; building searchable audio archives
# Transcribe 1-hour podcast
python scripts/main.py transcribe episode-42.mp3 --model medium
# Output: episode-42.txt (full transcript with timestamps)
# Processing time: ~5 min for 1 hour audio on M1 Mac
Example 2: YouTube Subtitles
# Generate SRT for video upload
python scripts/main.py transcribe marketing-video.mp4 --format srt
# Output: marketing-video.srt
# Upload directly to YouTube/Vimeo
Example 3: Batch Process Interview Library
# Transcribe all recordings in folder
python scripts/main.py batch ./customer-interviews/ --model small --format txt
# Output: ./customer-interviews/*.txt (one per audio file)
Model Selection Guide
Model
Speed
Accuracy
VRAM
Best For
tiny
Fastest
~70%
1GB
Quick drafts, short clips
base
Fast
~80%
1GB
Social media clips
small
Medium
~85%
2GB
Podcasts, interviews
medium
Slow
~90%
5GB
Professional transcripts
large
Slowest
~95%
10GB
Critical accuracy needs
Recommendation: Start with small for most marketing content. Use medium for client deliverables.
Output Formats
Format
Extension
Use Case
txt
.txt
Blog posts, analysis
srt
.srt
Video subtitles (YouTube)
vtt
.vtt
Web video subtitles
json
.json
Programmatic access
tsv
.tsv
Spreadsheet analysis
Performance Tips
GPU acceleration - 10x faster with CUDA GPU
Audio extraction - Script auto-extracts audio from video
Chunking - Long files auto-split for memory efficiency
Language detection - Automatic, or specify with --language