Skip to content

Latest commit

 

History

History
67 lines (48 loc) · 4.86 KB

README.md

File metadata and controls

67 lines (48 loc) · 4.86 KB

Reddit Media Downloader

badge badge codecov lines of code

Update as of July, 2023

Due to the Reddit API changes, RMD will no longer function. First the Reddit admins destroyed PushShift, the platform RMD heavily relied on for historical data, and now they have completely restricted access to their direct API.

In conjunction, these actions make it impossible for RMD to operate. It would have been possible to require users to register their own application keys in order to continue, but this process has also now been restricted by Reddit. Additionally, I (the primary dev of RMD) not longer wish to work with or support anything involving the company. While this was already a discouraging factor before the latest changes, this latest debacle has made it clear where Reddit stands.

I'll leave the project up for a little while longer, then likely archive it all and move on. I'll presrve as much as possible when I do - including the original README below. Other users are welcome to fork the project and continue onward, if anybody is willing to continue in spite of the Admin actions pushing against them.

Thanks for all the support for the project over the years. It's been great. Catch you at the next one.

~ ShadowMoose

Original text below:

Let's face it: In this day and age, the internet is ephemeral. Anything anybody posts might be here one day, and gone the next. Websites take down or move their images and videos, posts get hidden or removed, and their content is lost. Even more so on Reddit, where accounts are constantly springing into existence - and then vanishing as quickly without a trace. How's anybody supposed to keep their cherished cat picture collection around with all this change? Well fear not, my data-hoarding friend, because Reddit Media Downloader is here for you!

RMD Preview Image

What is this?

Reddit Media Downloader is a program built to scan Comments & Submissions from multiple sources on Reddit, and download any media they contain or link to. It can handle scanning posts from your personal Upvoted/Saved lists, subreddits of your choice, user-curated multireddits, and more! When it finds a Comment or Submission from wherever you specify, it will parse the text and links within to find any media linked to. It then uses multiple downloaders to save this media locally onto your disk.

RMD comes equipped with a suite of options to let it scan just about anywhere you can find media on Reddit. Coupled with its powerful baked-in Filter options to let you specify exactly what type of posts and comments you're looking for ("I only want Submissions with 'Unicorn' in the title, and no less than 1000 upvotes!"), RMD makes automatically saving things a simple process. Built in Python and runnable headless (without a GUI) or as its own server, you can launch this program anywhere - and it's built from the ground-up to make automation a breeze.

Check out the different places RMD can scan!

Things RMD Can Do:

  • Extract links inside comments, links in Submissions, and links within selfpost text.
  • Work with links to most video sites, image hosts, and image blogs.
  • Avoid saving duplicates of the same file, by using image recognition to compare similar pictures.
  • Automatically seek to - and resume - where it last left off downloading.
  • Launch a web-based UI (locally or remotely) to make even the most complex configuration setups simple.

Getting Started:

Click here to visit the documentation site!

New Feature Requests or Issues?

If you hit any links which RMD does not support, find anything broken, need assistance, or just want to suggest new features, please open a new request here.

Updates?

RMD is currently under a large-scale rewrite in a new language, which will greatly expand its capabilities. If you don't see much recent activity in the master branch, or in the bug reports, it's probably because the rewrite already fixes the problems or adds the requested features. In the meantime, the current release of RMD is considered extremely stable, and should work exactly as expected.