The Main Character Files

The Main Character FilesReddit-to-TikTok Pipeline

Scrape viral posts, generate narrated videos, publish to TikTok — fully automated.

Module Reference

Two Video Formats

Classic narrated videos with word-highlighted captions, or Messages format that rewrites posts as dramatic iMessage conversations via LLM.

End-to-End Automation

Cron-scheduled pipeline fetches Reddit posts, generates video, and publishes to TikTok with zero manual intervention.

Stealth Browser

Uses Camoufox (Firefox-based stealth browser) for Reddit scraping and TikTok uploads, with human-like delays to avoid detection.

Word-Level Captions

Kokoro TTS + Whisper alignment produces per-word timestamps for animated subtitle effects — highlight, karaoke, and static.

Architecture

See Module Overview for the full dependency graph.