This Ruby script saves Reddit posts into local Markdown files for easy reading, sharing, and archiving. Both post body and replies are supported. You can then use any Markdown reader or knowledge management software to manage the saved posts.

1. Install Ruby on your device
   • https://www.ruby-lang.org/en/documentation/installation/
2. Download the latest release of this script
3. Open a terminal
4. Run the script with the following command:
   • ruby reddit-markdown.rb
   • If you call the script from a different folder, you need to specify the path to the script
     • ruby /path/to/reddit-markdown.rb
   • Tip: Starting with the 1.7.0 release, command-line arguments are supported. See Command-line Arguments for details. If you use that option, you can skip the next step.
   • Tip: You can rename the script to anything and place it anywhere you want
5. Enter the link(s) to the Reddit post(s) you want to save
   • If you have multiple links, separate them by commas.
   • If you need a demo, enter demo.
   • If you want a surprise, enter surprise.
   • If you want to save currently trending posts in a subreddit, enter r/[SUBREDDIT_NAME], e.g. r/pcmasterrace.
     • Note: This feature is only available in v1.5.0 and above.
   • If you have a multireddit (i.e. collection of multiple subreddits) defined in settings.json, enter its name, e.g. m/stocks.
     • Note: This feature is only available in v1.6.0 and above.
6. Enter the path where you want to save the Markdown file(s).
   • Leave blank to save in the same folder (where you called the script from)
   • Starting from v1.4.0, posts can also be saved as HTML files. To do so, get the updated settings.json file from that release, and use the file_format option. Accepted values are html and md.
   • Tip: Starting with the 1.1.0 release, you can set a default path in the settings.json file. See Custom Settings for details.

Starting with the 1.7.0 release, command-line arguments are supported to facilitate automation and integration with other programs (see Automation for details)

This is in addition to the existing interactive mode. You can pass input to the script via either method (to use the interactive mode, simply do not pass any command-line arguments). However, in the future, the interactive mode is scheduled to be removed, so it is recommended to adopt command-line arguments as soon as possible.

The following arguments are available:

Tip: You can use multiple options at once! For example, you can pass in a list of URLs, a list of subreddits, and a list of multireddits, and the script will save all of them.

Starting with the 1.1.0 release, a number of settings can be customized. They can be found in the settings.json file bundled with the script.

If you are using an older release, make sure to get the latest version of the script (plus the settings.json file) to tweak these settings. On the other hand, if you are on the latest release but somehow don't have the settings.json file, you can get it directly from this repository.

Note: Settings exposed in settings.json are locked to a specific version of the script. If you are using different editions of the two files, you may get unexpected results. It is recommended to always use the latest version of both files.

_{1. The path string must be set as an environment variable. The key name in settings.json and for your environment variable must be DEFAULT_REDDIT_SAVE_LOCATION. See Use environment variables in Terminal on Mac, Create and Modify Environment Variables on Windows, or How to Set Environment Variables in Linux for more details.}

This section describes a potential workflow to automate the process of saving Reddit posts. It is not meant to be a comprehensive guide, but rather a starting point for you to build upon.

We are going to use GitHub Actions to automate the process. If you are not familiar with GitHub Actions, please read GitHub's guide on getting started with GitHub Actions first.

Here is a sample GitHub Actions workflow which triggers the reddit_markdown.rb script every two hours:

name: Fetch Reddit posts

on:
  workflow_dispatch:
  schedule:
    - cron: '0 */2 * * *'

jobs:
  run_ruby_script:
    runs-on: self-hosted

    steps:
    - name: Check out repository
      uses: actions/checkout@v3
	
	- name: Set up Ruby
	  uses: ruby/setup-ruby@v1
	  with:
		ruby-version: 2.7

    - name: Run script
      run: |
        ruby reddit_markdown.rb --multis m/fav,m/stocks,m/programming,m/travel

You can customize this workflow according to your needs. For example, you can modify the cron schedule to adjust the frequency of the script execution, or change the command-line arguments to others (see Command-line arguments for more details).

The above workflow uses a self-hosted runner for convenience. To set up a self-hosted runner, please read GitHub's guide on setting up a self-hosted runner first. If you prefer to use a GitHub-hosted runner, you might need to set up additional steps to appropriately save and retrieve the downloaded Markdown files from that runner (e.g. by uploading them to a cloud storage service such as S3 and downloading them back to your local machine if needed).

Starting in v1.9.0, the feature to organize posts into timestamped directories is now available. By default, this feature is disabled to maintain backward compatibility. To enable the feature, open the settings.json file and set the use_timestamped_directories option to true. The change will take effect the next time you run the script.

Organizing posts into timestamped directories allows you to easily locate posts based on their date. For instance, saved posts with a timestamp of 2020-01-01 12:00:00 will be moved to a directory named 2020-01-01. The new path for one of those posts will be: <base_dir>/subreddit/2020-01-01/<post>.md

If you have already downloaded posts prior to enabling the timestamped directories feature, you can use the timestamped_subs.rb script to retrospectively organize them. This will enhance your browsing experience and reduce clutter in your file system.

It's important to note that using this script is entirely optional. If you prefer to not place your posts into timestamped directories, you don't need to use it. The script is provided as a convenient tool for users who want a more organized directory structure for their saved Reddit posts.

The script works by:

1. Scanning a base directory for .md files that represent saved Reddit posts.
2. For each file, it extracts the timestamp from the post's content.
3. It then uses this timestamp to create a new directory (if it doesn't already exist).
4. The script then moves the file to this new directory.

The script is smart enough to ignore files that are already in a timestamped directory.

You will need to set the base_dir variable in the script to the directory where your saved Reddit posts are located. This base directory path is relative to the directory where you run this script.

Once you've done that, you can simply run the script by using the ruby command followed by the script name in your terminal:

ruby reddit_post_organiser.rb

The script will then print out log messages indicating which files it is processing, whether it's created any new directories, and whether it's moved any files.

Make sure to back up your files before running this script to prevent any unintended data loss.

• Open source, and free
• Automation-friendly
• No authentication/sign-in of any kind needed
  • Publicly available data. Safe and no security concerns
• Look and feel similar to browsing Reddit on desktop web
  • Bonus: Plenty of customizations available
• Supports both text and multimedia posts
• Runs anywhere Ruby runs
  • Ruby is cross-platform
  • Core logic is platform-agnostic so it can be translated into any other programming languages to run anywhere
• Markdown and HTML for universality

• Only replies that are visible by default on the web are saved
  • Reddit hides a subset of replies based on upvotes that you can manually click to show. Those won't be saved by this script.
• Only supported on desktop
  • But you could remote session from a phone to run the script
• Need Ruby installed first
• Personal side project with limited bug fixes and features past the initial release
  • Pull requests are welcome