Skip to content

README.md

Latest commit

 

History

History
74 lines (52 loc) · 1.55 KB

README.md

File metadata and controls

74 lines (52 loc) · 1.55 KB

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.