🎬 CTX-Reels

AI-powered faceless short-form video generator. Create TikTok / Reels / Shorts from a topic in one command.

ctx generate -t "Cristiano Ronaldo"

Script → Voice → Karaoke Subtitles → Video — all automated.

✨ Features

• One-command video generation from any topic
• 3 voice engines: Kokoro (free, local), Edge-TTS (free, cloud), ElevenLabs (premium)
• Word-level karaoke subtitles — active word highlights in white against yellow text
• Smart script writing via Gemini AI with viral hooks and punchy delivery
• Batch generation from a JSON file of topics
• Customizable — fonts, colors, backgrounds, voices, output dir

📦 Install

npm install -g ctx-reels
ctx setup

Prerequisites

| Dependency | Required | Install | |---|---|---| | Node.js ≥ 18 | ✅ | nodejs.org | | FFmpeg + FFprobe | ✅ | brew install ffmpeg / apt install ffmpeg | | Python 3 | ✅ (for subtitles) | python.org | | Gemini API Key | ✅ (for scripts) | aistudio.google.com |

ctx setup will create a Python virtualenv and install faster-whisper automatically.

🚀 Quick Start

# 1. Generate a full reel
ctx generate -t "Elon Musk"

# 2. Batch generate from a list
echo '["AI Revolution", "Space Exploration", "Bitcoin"]' > topics.json
ctx batch topics.json

# 3. Run individual steps
ctx script -t "My Topic"
ctx voice -s output/scripts/my-topic.txt
ctx subs -a output/audio/my-topic.mp3
ctx render -a output/audio/my-topic.mp3 -s output/subtitles/my-topic.ass

🎤 Voice Engines

| Engine | Cost | Quality | Setup | |---|---|---|---| | Kokoro (default) | Free | ⭐⭐⭐⭐ | Automatic (downloads 80MB model on first run) | | Edge-TTS | Free | ⭐⭐⭐ | pip install edge-tts | | ElevenLabs | Paid | ⭐⭐⭐⭐⭐ | API key in .env |

# List available voices for your engine
ctx voices

# Switch engine in .env
VOICE_ENGINE="kokoro"    # or "edge-tts" or "elevenlabs"

⚙️ Configuration

Edit .env (created by ctx setup):

# API Keys
GEMINI_API_KEY="your-key-here"

# Voice
VOICE_ENGINE="kokoro"
KOKORO_VOICE="af_heart"

# Output directory (default: ~/Desktop/ctx)
CTX_OUTPUT="/path/to/custom/output"

# Background video/image
BG_ASSET="./templates/backgrounds/minecraft.mp4"

See .env.example for all options.

📁 Output Structure

~/Desktop/ctx/
├── scripts/     # Generated text scripts
├── audio/       # Generated voice audio (MP3)
├── subtitles/   # Karaoke subtitles (ASS)
└── reels/       # Final rendered videos (MP4)

🛠 CLI Reference

| Command | Description | |---|---| | ctx generate -t <topic> | Full pipeline: script → voice → subs → video | | ctx generate -t <topic> -f | Force regenerate (overwrite existing) | | ctx batch <file.json> | Batch generate from JSON array of topics | | ctx script -t <topic> | Generate script only | | ctx voice -s <script.txt> | Generate voice only | | ctx subs -a <audio.mp3> | Generate subtitles only | | ctx render -a <audio> -s <subs> | Render video only | | ctx voices | List available voices | | ctx setup | First-time dependency setup |

📄 License

MIT — by cecamarty