README.md

Subreddit Media Downloader

Download images and videos from any public subreddit without using Reddit's API

_{Made with ❤ by Nico}

💬 About:

This script allows you to download directly linked images, videos and gifs from any public subreddit WITHOUT USING REDDIT'S API.

How is this achieved? By using the very powerful PushShift API. This is important for a number of reasons:

• With Reddit's api, you have a limit of 1000 posts, pushshift is unlimited.
• In my experience, pushshift is just faster.
• You don't need a client id and secret, which is tedious to create and can be hard if it's your first time.
  • Actually...you don't need any authentication at all!

There is one caveat tho, some of PushShift shards (think of them as servers) are sometimes down, so you might not get the whole data in those cases. However, you're probably getting more than with Reddit's api, so it's worth it 😁

✨ Features:

• 🖼️ Download directly linked images and gifs from any public subreddit.
• 🎞️ Download directly linked videos from any public subreddit.
• 📅 Download files before and/or after a certain date.

🔧 Setup:

Install the dependencies:

python -m pip install -r requirements.txt

⚠️ Make sure you install FFmpeg. Otherwise the script will crash ⚠️

Fill in the config.ini file as needed. There you can set:

• Destination folder.

🖥️ Usage:

Simply run the file main.py and pass the arguments and it will start downloading.

Takes three arguments:

• --subreddit (required)
• --after (optional)
• --before (optional)

Example:

python3 main.py --subreddit="memes" --after="2022-01-01" --before="2022-12-01"

📚 Dependencies:

• PSAW: Pushshift.io API Wrapper.
• tqdm: Progressbar.
• aiohttp: Async http client/server framework.
• aiofiles: File support for asyncio.
• ffmpeg-python: Python bindings for FFmpeg.

📃 License:

GNU General Public License v3.0.