Bottube 🎥

Turn Reddit threads into narrated YouTube videos using AI. Fully automated. Fully chaotic.

🚀 What It Does

Bottube scrapes Reddit posts, uses AI to write and voice a story, generates matching visuals, composes a video, and uploads it straight to YouTube.

🧠 Features

• Scrapes Reddit for hot/controversial/funny threads
• Claude or ChatGPT turns them into narrations
• ElevenLabs adds realistic voiceover
• HuggingFace/CivitAI generate matching images
• Adds audio, background, timing, and overlays
• Auto-upload via YouTube Data API

⚙️ Requirements

• Python 3.10+
• FFmpeg
• Google Cloud project with YouTube Data API
• HuggingFace + ElevenLabs + Claude/OpenAI keys
• Reddit API credentials

🔐 Credentials Setup

1. .env file: Place in project root.

REDDIT_CLIENT_ID=...
REDDIT_CLIENT_SECRET=...
REDDIT_USERNAME=...
REDDIT_PASSWORD=...
REDDIT_USER_AGENT=...
CLAUDE_API_KEY=...
HUGGINGFACE_TOKEN=...
ELEVENLABS_API_KEY=...
CIVIT_API_KEY=...

2. Google Cloud JSON: Download your service account key and save as:

credentials/google_creds.json

📦 Installation

git clone https://github.com/yourname/bottube.git  
cd bottube  
pip install -r requirements.txt

🛠️ Usage

python main.py

🔧 Customization

• Change subreddits & filters in config.py
• Tweak prompt/voice/style in story_engine.py
• Edit templates, overlays, or durations in video_maker.py

📸 Output

Generates a full video (visuals + voice + BGM) and uploads it to your linked YouTube channel.