Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/manojkarthick/reddsaver
CLI tool to download saved and upvoted media from Reddit
https://github.com/manojkarthick/reddsaver
reddit reddit-api rust
Last synced: 3 months ago
JSON representation
CLI tool to download saved and upvoted media from Reddit
- Host: GitHub
- URL: https://github.com/manojkarthick/reddsaver
- Owner: manojkarthick
- License: apache-2.0
- Created: 2020-11-28T23:03:15.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2023-09-08T02:03:08.000Z (about 1 year ago)
- Last Synced: 2024-07-08T07:25:09.603Z (4 months ago)
- Topics: reddit, reddit-api, rust
- Language: Rust
- Homepage:
- Size: 216 KB
- Stars: 142
- Watchers: 5
- Forks: 7
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
- awesome-browserless - Reddsaver - CLI tool to download saved and upvoted media from Reddit (Social media / Reddit)
README
# Reddsaver  [](https://crates.io/crates/reddsaver)
* Command line tool to download saved/upvoted 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](https://www.ffmpeg.org/download.html) for installation instructions.
### Recommended method
You can download release binaries [here](https://github.com/manojkarthick/reddsaver/releases)
### Alternative methods
#### Using MacPorts
If you are a macports user on macOS, you can install reddsaver using `port`:
```
sudo port selfudpate
sudo port install reddsaver
```
#### Using Homebrew
If you are a homebrew user on macOS, you can install using `brew tap`:
```shell
brew tap manojkarthick/reddsaver
brew install reddsaver
```
#### Arch Linux
If you are an ArchLinux user, then you can use a tool like `yay` or `paru` to install it from the [AUR](https://aur.archlinux.org/packages/reddsaver-bin/):
```shell script
yay -S reddsaver
```
#### Using cargo
If you already have Rust installed, you can also install using `cargo`:
```shell script
cargo install reddsaver
```
#### Using nix
If you are a [nix](https://github.com/NixOS/nix) user, you can install reddsaver from [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/applications/misc/reddsaver/default.nix)
```shell script
nix-env --install reddsaver
```
or, if you manage your installation using [home-manager](https://github.com/nix-community/home-manager), add to your `home.packages`:
```shell script
home.packages = [
pkgs.reddsaver
];
```
#### Building and running from source
Make sure you have rustc `v1.50.0` and cargo installed on your machine.
```shell script
git clone https://github.com/manojkarthick/reddsaver.git
cargo build --release
./target/release/reddsaver
```
#### Docker support
Pre-built docker images are available on [Docker Hub](https://hub.docker.com/u/manojkarthick)
```shell script
mkdir -pv data/
docker run --rm \
--volume="$PWD/data:/app/data" \
--volume="$PWD/reddsaver.env:/app/reddsaver.env" \
manojkarthick/reddsaver:latest -d /app/data -e /app/reddsaver.env
```
## Running
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: -reddsaver
* 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 `reddsaver.env`:
```shell script
CLIENT_ID=""
CLIENT_SECRET=""
USERNAME=""
PASSWORD=""
```
_NOTE_: If you have 2FA enabled, please make sure you set `PASSWORD=:<2FA_TOTP_token>` instead
4. Run the app!
```shell script
# Create a directory to save your images to
mkdir -pv reddsaver/
# Check if you installation is working properly
reddsaver --help
# Check if the right configuration has been picked up
# NOTE: In case the `USERNAME` variable is being overriden by
# your system username, please use
# On Linux/Mac - unset USERNAME
# On Windows - set USERNAME=
# before running to temporarily remove the system username
# from your environment
reddsaver -e reddsaver.env -d reddsaver --show-config
# Run the app to download the saved media
reddsaver -e reddsaver.env -d reddsaver
# Also allows you to download upvoted media
reddsaver -e reddsaver.env -d reddsaver --upvoted
```
NOTE: When running the application beyond the first time, if you use the directory as the initial run, the application will skip downloading the images that have already been downloaded.
View it in action here:
[](https://asciinema.org/a/382339)
## Description and command line arguments
Optionally override the values for the directory to save and the env file to read from:
```shell script
ReddSaver 0.4.0
Manoj Karthick Selva Kumar
Simple CLI tool to download saved media from Reddit
USAGE:
reddsaver [FLAGS] [OPTIONS]
FLAGS:
-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
-s, --show-config Show the current config being used
-U, --undo Unsave or remote upvote for post after processing
-u, --upvoted Download media from upvoted posts
-V, --version Prints version information
OPTIONS:
-d, --data-dir Directory to save the media to [default: data]
-e, --from-env Set a custom .env style file with secrets [default: .env]
-S, --subreddits ... Download media from these subreddits only
```
Some points to note:
* By default, reddsaver generates filenames for the images using a MD5 Hash of the URLs. You can instead generate human readable names using the `--human-readable` flag.
* You can check the configuration used by ReddSaver by using the `--show-config` flag.
## Other Information
### Building for Raspberry Pi Zero W
To cross-compile for raspberry pi, this project uses [rust-cross](https://github.com/rust-embedded/cross). Make sure you have docker installed on your development machine.
1. Build the docker image for rust-cross: `docker build -t rust-rpi-zerow:v1-openssl -f Dockerfile.raspberrypizerow .`
2. Make sure that the image name used here matches the image name in your `Cross.toml` configuration
3. Run `cross build --target arm-unknown-linux-gnueabi --release` to build the project
4. You can find the compiled binary under `target/arm-unknown-linux-gnueabi/release/`