Package Exports

ctx-reels
ctx-reels/src/modules/pipeline.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (ctx-reels) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

🎬 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