chirag127/redvault

RedVault

Python CLI for downloading and archiving Reddit media (videos, images, GIFs) via yt-dlp. No API key required.

Live Site

https://chirag127.github.io/redvault/

Install

pip install yt-dlp  # required dependency
pip install -e .    # install redvault

Usage

# Download a single Reddit post
redvault download --url https://reddit.com/r/aww/comments/...

# Download top 50 posts from a subreddit
redvault download --subreddit aww --limit 50 --output ./archive

# Download as MP3 (audio only)
redvault download --url <url> --format mp3

# Suppress yt-dlp output
redvault download --url <url> --quiet

Features

• Download videos, images, GIFs from any Reddit post
• Bulk download from any subreddit (no auth needed — uses public JSON API)
• Powered by yt-dlp for best quality + format selection
• Configurable output directory and format (best/mp4/mp3)
• Clean modular architecture: CLI / core separation

Project Structure

redvault/
  cli/commands.py       CLI (Click)
  core/downloader.py    Download logic (yt-dlp + Reddit JSON API)
tests/                  pytest tests
pyproject.toml          build config
docs/                   GitHub Pages site

License

MIT