🐰 Welcome to Grabbit! 🐰

A Reddit saved post media and metadata downloader.

📥 Installation (recommended)

pipx install git+https://github.com/devicarus/grabbit.git

⚙️ Configuration

1. Create a Reddit app with the following values:

   • name anything, e.g. Grabbit
   • 🔘 script
   • redirect URI http://localhost:8080

2. Create a .json file with the following structure:

   {
     "username": "YOUR_REDDIT_USERNAME",
     "password": "YOUR_REDDIT_PASSWORD",
     "client_id": "YOUR_CLIENT_ID",
     "client_secret": "YOUR_CLIENT_SECRET"
   }

🚀 Usage

> grabbit --help

Usage: grabbit [OPTIONS] OUTPUT_DIR USER_CONFIG

  OUTPUT_DIR is the directory where the downloaded files will be saved
  USER_CONFIG is the path to a JSON file containing Reddit user credentials

Options:
  -d, --debug     Turn on activate debug mode.
  --csv FILENAME  Use Reddit GDPR saved posts export CSV file.
  --skip-failed   Skip previously failed downloads.
  --version       Show the version and exit.
  --help          Show this message and exit.

📦 Dependencies

• Python 3.12+ (tested on 3.13)
• ffmpeg (optional, video downloads may not work properly without it)

❓ FAQ

Grabbit is only downloading the latest ~1k saved posts

Reddit's API only allows access to the latest circa 1000 saved posts.
To download all saved posts, you can request your Reddit data and use the --csv option with the exported CSV file.

What does Grabbit download?

Grabbit downloads (or at least tries to) all media from saved posts, including images and videos, as well as metadata such as title, author's username and text if there is any.
Grabbit does not download comments.
Grabbit is not intended for backing up entire subreddits or other users' profiles.