Gert

A command line tool to download media from Reddit

• Supports:
  • Reddit: PNG/JPG images, GIFs, Image galleries, videos
  • Giphy: GIFs
  • Imgur: Direct images and GIFVs
  • Gfycat/Redgifs: GIFs
• GIF/GIFV from Imgur/Gfycat/Redgifs are downloaded as mp4
• Does not support downloading images from Imgur post links

Installation

Prerequisites

To download videos hosted by Reddit, you need to have ffmpeg installed. Follow this link for installation instructions.

Using cargo

If you already have Rust installed, you can install using cargo: shell script cargo install gert

Running

Simply pass the names of the subreddits you want to download media from with (multiple) -s flags

bash gert -s wallpapers -s earthporn

Command line options

```bash Simple CLI tool to download media from Reddit

USAGE: gert [FLAGS] [OPTIONS] --subreddit ...

FLAGS: --debug Show the current config being used -r, --dry-run Dry run and print the URLs of saved media to download -h, --help Prints help information -H, --human-readable Use human readable names for files -V, --version Prints version information

OPTIONS: -e, --from-env Set a custom .env style file with secrets -f, --feed Feed to download from [default: hot] [possible values: hot, new, top, rising] -l, --limit Limit the number of posts to download [default: 25] -m, --match Pass a regex expresion to filter the title of the post -o, --output Directory to save the media to [default: .] -p, --period Time period to download from [default: day] [possible values: now, hour, day, week, month, year, all] -s, --subreddit ... Download media from these subreddit ```

Authenticating with Reddit

Authentication is not required but if you want a more generous rate limit you can create a new app in reddit and pass your credentials to gert

1. Create a new script application at https://www.reddit.com/prefs/apps
   • Click on create an app at the bottom of the page
   • Input a name for your application, for example: gert
   • Choose "script" as the type of application
   • Set "http://localhost:8080" or any other URL for the redirect url
   • Click on "create app" - you should now see the application has been created
   • Under your application name, you should see a random string - that is your client ID
   • The random string next to the field "secret" is your client secret
2. Copy the client ID and client secret information returned
3. Create a .env file with the following keys, for example gert.env:
   shell script CLIENT_ID="<client_id>" CLIENT_SECRET="<client_secret>" USERNAME="<username>" PASSWORD="<password>" NOTE: If you have 2FA enabled, please make sure you set PASSWORD=<password>:<2FA_TOTP_token> instead

Credits

based on https://github.com/manojkarthick/reddsaver