explaingit

elebumm/redditvideomakerbot

11,894PythonAudience · generalComplexity · 3/5Setup · moderate

TLDR

A Python bot that automatically converts Reddit threads into short-form videos with text-to-speech narration over gameplay footage, ready to post on TikTok, YouTube Shorts, or Instagram Reels.

Mindmap

mindmap
  root((RedditVideoMakerBot))
    What it does
      Reddit to video
      TTS narration
      Gameplay overlay
    Tech
      Python 3.10
      Playwright
      Reddit API
    Features
      Light dark mode
      NSFW filter
      Custom background music
    Platforms
      TikTok
      YouTube Shorts
      Instagram Reels
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Automate production of Reddit story videos for your TikTok or YouTube Shorts channel without manual editing.

USE CASE 2

Generate narrated clips from any subreddit with customizable background gameplay video and music.

USE CASE 3

Filter NSFW content and choose between light or dark video styles for consistent channel branding.

Tech stack

PythonPlaywrightReddit API

Getting it running

Difficulty · moderate Time to first run · 30min

Requires Python 3.10, a Reddit developer API key, and Playwright with browser binaries installed.

In plain English

elebumm/RedditVideoMakerBot is a Python script that automatically generates short-form videos from Reddit threads. The format it produces is a common one on TikTok, YouTube Shorts, and Instagram Reels: a screenshot of a Reddit post or comment read aloud with a text-to-speech voice, playing over gameplay footage with background music. The bot handles the entire assembly process, pulling content from Reddit and combining it into a finished video file. To use it, you connect it to your Reddit account through Reddit's developer API, then run a single command. The bot prompts you to configure your preferences, such as which subreddit to pull from, what background video to use, and which voice to use for narration. The result is a video file saved to your computer that you then upload to a platform manually. The bot does not handle uploading, to avoid triggering platform content policies. Setup requires Python 3.10 and involves installing a few dependencies, including Playwright, a tool for automating web browsers. The README walks through installation steps, and a separate documentation site covers things in more detail. The project was built to automate a type of video content that had become popular on social media but required repetitive manual work to produce. Over time, features were added including light and dark mode video styles, an NSFW content filter, the option to select a specific Reddit thread rather than a random one, and customizable background music. The README includes a checklist showing which planned features have been completed. The project is maintained by a small named team and is open to contributions from anyone. A Discord server is available for questions and support.

Copy-paste prompts

Prompt 1
I'm using elebumm/RedditVideoMakerBot. Help me modify the config so it always picks the top post of the week from r/AmItheAsshole and saves the output video with the post title as the filename.
Prompt 2
Using RedditVideoMakerBot, help me write a shell script that runs the bot once a day via cron and moves finished videos into a folder named with today's date.
Prompt 3
I want to add an auto-upload step to RedditVideoMakerBot after the video is generated. Show me where in the code to hook in a TikTok upload call and what Python library handles it.
Prompt 4
Help me extend RedditVideoMakerBot to burn subtitles directly into the video using the same transcript the TTS step already produces.
Open on GitHub → Explain another repo

← elebumm on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.