/reddit-save

Saves Reddit post content.

Primary LanguageTypeScriptMIT LicenseMIT

reddit-save

A simple script that saves Reddit post content.

Note:

  • Has only been tested on Windows (11) so far.
  • The code is messy and inefficient. Not particularly going for quality here, just kind of getting it done before Imgur pulls a Tumblr on us on May 15, 2023.
  • The script is opinionated. You may have to tinker with the code a bit, if the default behavior doesn't appeal to you.
  • Updates might come, with more functionality and improved code quality, and added customizability.
  • Deleted posts are not handled properly at the moment. If the option 'save-deleted' is enabled, the script will save the post's data to the 'deleted' subfolder. However, sometimes the content is not really deleted, but the script treats it as deleted since the Reddit data says the post was deleted. I haven't found an absolute way to determine this yet.
  • Has not been published to npm yet, so you'll have to clone the repo and run it locally.
  • Contributions are welcome! Feel free to open a pull request or an issue.

Prerequisites

  • Reddit Data

    1. Request your data from Reddit (GPDR) here. This might take a while, so it's recommended to do this in advance.
    2. Download the zip archive once the download is ready.
    3. Extract the zip archive and copy that folder into the root of this project.
    4. Rename the folder to data for simplicity. Reddit-save checks here by default, but you can use any name as long as you set the --input or -i flag.

  • Reddit App

    1. Create a Reddit app here. It should be a personal use script. The redirect URI doesn't matter; it can be set to anything. However, you'll have to come back to this page in the next (Config) prerequisite though, to get your client ID and client secret, and to generate your refresh token. To get your refresh token, you'll need to change the redirect URI. So, just change it now instead.
    2. Set your Reddit app's redirect URI to https://not-an-aardvark.github.io/reddit-oauth-helper/.
    3. Make note of your Reddit app's client ID and client secret. You'll need them in the next (Config) prerequisite.

  • Config

    1. Run the script once to generate the default config: npm start.
    2. Set REDDIT_USERNAME to your Reddit username, in the .env file.
    3. Set REDDIT_CLIENT_ID to your Reddit app's client ID, in the .env file.
    4. Set REDDIT_CLIENT_SECRET to your Reddit app's client secret, in the .env file.
    5. Ensure your Reddit app's redirect URI is set to https://not-an-aardvark.github.io/reddit-oauth-helper/. This is a tool that helps you generate a refresh token.
    6. Head over here in your browser
    7. Under "Generate Token", input your client ID and client secret.
    8. Check the "Permanent?" box, or leave it blank and it will expire in an hour. You can manually revoke tokens when you're done with them by sending a request to https://www.reddit.com/api/v1/revoke_token (see the Wiki for more), or by visiting the installed apps page here.
    9. Check the following required scopes: history, read.
    10. Click the "Generate Token" button.
    11. Copy, then set REDDIT_REFRESH_TOKEN to your generated refresh token, in the .env file.

  • Gallery-dl (used for downloading media content)

    1. Download the appropriate gallery-dl binary for your system here, and place it in the root of this project. Alternatively, you can install it with pip install -U gallery-dl, if you have Python 3 installed.
    2. Rename the binary to gallery-dl (or gallery-dl.exe on Windows), if necessary.
    3. Run gallery-dl oauth:reddit and follow the instructions on the opened webpage to authenticate your Reddit account with gallery-dl.

Usage

  1. Clone this repository: git clone https://github.com/shaunbharat/reddit-save.
  2. Navigate inside the project directory: cd reddit-save.
  3. Install dependencies: npm install.
  4. Prepare your Reddit data, as described in the prerequisites.
  5. Prepare your Reddit app, as described in the prerequisites.
  6. Prepare your config, as described in the prerequisites.
  7. Prepare gallery-dl, as described in the prerequisites.
  8. Run the script: npm start. The options (CLI flags) will be listed.

Usage: npm start -- <file> [options]

By default, the script will save all posts to the posts folder, organized with subdirectories for subreddits. Basic information will be saved to post.json, in the post's specific directory. A thumbnail will also be saved, if available.

Next

The script saves enough information for compatibility with any future projects or updates.

It's possible I might create (if I get bored) a viewer part to this project in the future, that can display the saved content in a nice way. I might also add the ability to make custom post lists, since Reddit only has the saved posts list which is limited to 1000 posts.

License

Copyright (c) 2023 Shaun Bharat.

This project is licensed under the MIT license.