RedditVideoMakerBot: generating Reddit story videos from a single command

What RedditVideoMakerBot actually automates

The project targets a specific content format: a Reddit post read aloud over background footage, cut to a vertical aspect ratio for TikTok, YouTube Shorts or Instagram Reels. The README frames the motivation bluntly, saying these videos get millions of views and require very little effort, with the only original work being the editing and the gathering of materials. RedditVideoMakerBot exists to remove that work.

The audience is narrow and clear. It is for someone who wants to publish story videos regularly without opening a video editor, and who is comfortable running a Python project from a terminal. The README says the code was kept simple so that anyone can read it and contribute at any skill level, which suggests the maintainers expect tinkerers rather than a managed product. If you want a hosted service with a web dashboard, this is not that. If you want a script you can read, modify and run locally, it is aimed at you.

How a thread becomes a rendered video

The repository layout shows the pipeline split across directories: reddit/ for fetching, TTS/ for narration, video_creation/ for assembly, and utils/ for shared code. main.py is the entry point, and the README shows it being run directly. Dependencies in requirements.txt name the rest of the stack: praw for the Reddit API, gTTS and elevenlabs and pyttsx3 for speech, moviepy and ffmpeg-python for video, playwright for browser automation, and yt-dlp for pulling background footage.

That dependency list is the architecture in miniature. The bot authenticates to Reddit through praw, collects a post and its comments, sends the text through a text-to-speech backend, and then composites the audio with background video and subtitles into a finished file. Playwright appears in the requirements because some steps need a real browser rather than an HTTP call, which is also why the install instructions ask for both the Playwright package and its system dependencies.

The README is explicit about where the pipeline stops: the bot will not upload the result, and it says this is deliberate, to avoid community guideline issues. You get a file and you post it yourself. That single decision shapes what the tool is. It is a renderer, not a publisher.

Installing RedditVideoMakerBot and running it once

The README lists Python 3.10 as a requirement and notes that Playwright should install automatically during installation. Clone the repository and move into it first:

git clone https://github.com/elebumm/RedditVideoMakerBot.git
cd RedditVideoMakerBot

Next create a virtual environment. The README gives separate commands for Windows and for macOS and Linux. On macOS and Linux the sequence is:

python3 -m venv ./venv
source ./venv/bin/activate
pip install -r requirements.txt

Then install the browser layer. This is the step most likely to fail on a minimal machine, because install-deps reaches into the system package manager:

python -m playwright install
python -m playwright install-deps

The README marks an installation script as experimental for macOS and Linux on Debian, Arch, Fedora, CentOS and distributions based on those. It requires bash and can also be used to update an existing installation:

bash <(curl -sL https://raw.githubusercontent.com/elebumm/RedditVideoMakerBot/master/install.sh)

Start the bot with python main.py. On first run it prompts for your Reddit API details and your preferences. Before that prompt you need a Reddit app of type script, created at the Reddit Apps page, with any URL in the redirect field; the README uses https://jasoncameron.dev as its example. The bot writes your answers into config.toml. To change one later, the README says to delete the relevant lines from config.toml and let the next run reconfigure them. If a command fails, the README suggests trying python3 and pip3 instead of python and pip.

Where the one-command promise breaks down

The title promises one command, but the install path is five steps plus a manual trip to the Reddit Apps page. That is not a flaw in itself, though it does mean the first run is closer to setting up a development environment than to installing an app.

The more substantive limitation is the absence of a command line interface. The README's own improvement checklist still has an unchecked box for creating better documentation and adding a command line interface. Until that box is ticked, the intended interaction is an interactive prompt writing into config.toml, which is awkward to script and awkward to run unattended. If you were hoping to wire this into a scheduler that renders a video every morning, the configuration model works against you: you edit a TOML file by hand and delete lines to force a re-prompt.

There is also a licensing and content question the README does not address. The project is GPL-3.0, and the README separately notes that the Roboto fonts bundled with it are under Apache License V2. Nothing in the README discusses the rights attached to the Reddit posts you pull or the background footage you supply, and the bot deliberately does not upload, so that judgement stays with you. Treat the output as something you are responsible for clearing, not something the tool clears for you.

RedditVideoMakerBot compared with assembling the pipeline yourself

The realistic alternative is not a competing bot; it is building the same pipeline from the same libraries. praw for Reddit, gTTS or elevenlabs for speech, moviepy and ffmpeg-python for compositing, yt-dlp for background material. Every one of those appears in this project's requirements.txt, so the difference is not capability, it is what has already been decided for you.

What RedditVideoMakerBot provides is the wiring: the order of operations, the text cleanup via clean-text and unidecode, the spaCy and transformers dependencies that suggest sentence handling, the light and dark modes, the NSFW post filter, the check for whether a video has already been created. Assembling that yourself is a weekend of work at minimum, and the small decisions, such as how to split a long comment into readable frames, are the tedious part.

The other alternative is a general-purpose editor with templates, which trades automation for control. RedditVideoMakerBot wins when you want volume and consistency; the manual route wins when every video needs a different treatment. The README's checklist of completed items, including choosing a specific thread, a specific subreddit, a background, and a voice, describes the range of control the project offers. It is parameterisation, not per-video editing.

Maintenance, licence and the cost of staying current

The last push to the default branch was on 2026-09-17, and the most recent release is 3.4.0 from 2025-10-28. The project is not archived. The release history is uneven: 3.2.1 in August 2023, 3.3.0 in June 2024, then 3.4.0 in October 2025. Anyone planning to depend on it should plan for long gaps between tagged versions rather than a steady cadence.

Upgrade cost is dominated by the pinned dependencies rather than the bot's own code. requirements.txt pins torch at 2.7.0, transformers at 4.52.4, playwright at 1.49.1 and moviepy at 2.2.1, among others. MoviePy 2.x was a breaking change from the 1.x line, so anyone carrying an older checkout will feel that jump. Playwright pins move with browser builds, which means an upgrade can require re-running python -m playwright install. The Dockerfile pins python:3.10.14-slim and installs ffmpeg through apt, so container builds inherit whatever that base image and the distribution's package mirrors provide.

On licensing, the repository is GPL-3.0. That matters if you intend to distribute a modified version or wrap the bot inside another product, because the licence carries obligations that a permissive licence does not. This is a description of the licence identifier, not legal advice; read the LICENSE file and take proper advice if you plan to redistribute.

Editorial conclusion

Adopt RedditVideoMakerBot if you have Python 3.10, a Reddit script app, and you want rendered story videos without touching an editor; the README's own workflow is a clone, a virtual environment, pip install, Playwright browsers, then python main.py. Do not adopt it if you need the bot to publish on your behalf, because the README states it will not upload and only hands you a file. Before committing, verify two things on your own machine: that python -m playwright install-deps succeeds on your distribution, and that a run finishes with a file you consider publishable, since the documentation does not describe a resume or rollback path for a failed render.

Frequently asked questions

Official sources

1. elebumm/RedditVideoMakerBot on GitHub
2. Issues
3. License: GPL-3.0
4. README
5. Releases