Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/956mb/reddit-download-button

Adds download buttons to more easily hoard images from Reddit
https://github.com/956mb/reddit-download-button

datahoarder downloader extension greasyfork images javascript post reddit tampermonkey

Last synced: 3 months ago
JSON representation

Adds download buttons to more easily hoard images from Reddit

Host: GitHub
URL: https://github.com/956mb/reddit-download-button
Owner: 956MB
License: mit
Created: 2024-07-25T00:45:11.000Z (6 months ago)
Default Branch: main
Last Pushed: 2024-10-06T13:57:26.000Z (3 months ago)
Last Synced: 2024-10-15T19:23:17.450Z (3 months ago)
Topics: datahoarder, downloader, extension, greasyfork, images, javascript, post, reddit, tampermonkey
Language: JavaScript
Homepage: https://greasyfork.org/en/scripts/501718-reddit-image-downloader
Size: 241 KB
Stars: 2
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

        


# Reddit Download Button

[![Greasy Fork Version](https://img.shields.io/greasyfork/v/501718?style=for-the-badge&logo=tampermonkey&logoColor=white&labelColor=4c4c4c&color=D93A00&borderRadius=8)](https://greasyfork.org/en/scripts/501718-reddit-image-downloader) [![Greasy Fork Total](https://img.shields.io/greasyfork/dt/501718?style=for-the-badge&logo=docusign&logoColor=white&label=installs&labelColor=4c4c4c&color=D93A00&borderRadius=8)](https://greasyfork.org/en/scripts/501718-reddit-image-downloader) [![Greasy Fork Daily](https://img.shields.io/greasyfork/dd/501718?style=for-the-badge&logo=addthis&logoColor=white&label=daily&labelColor=4c4c4c&color=D93A00&borderRadius=8)](https://greasyfork.org/en/scripts/501718-reddit-image-downloader) [![MIT License](https://img.shields.io/badge/License-MIT-D93A00.svg?style=for-the-badge&borderRadius=8)](https://opensource.org/licenses/MIT)

The browser extension that I've always wanted for Reddit... a download button for grabbing all the images within a post. It's exactly what a data hoarder needs! *Does not require Reddit login.*

![Reddit Image and Video Downloader](./img/screenshot.png)



## Features

- Adds a download button next to the share button on Reddit posts

- Supports downloading single images, entire image galleries, and GIFs

- Works on both the Reddit feed and individual post pages

- Detects the highest resolution version of images for download

>[!WARNING]

> Currently the extension doesn't work on videos due to some `m3u8` shenanigins I couldn't get to work. Please feel free to help with an [issue](https://github.com/956MB/reddit-download-button/issues) or [pull request](https://github.com/956MB/reddit-download-button/pulls).

## Supported Browsers:

##### *Chromium-based*

| Browser | Last Tested Version (Chromium Engine) |

|:--------|:--------------------------------------|

| [Arc](https://arc.net/download) | 1.49.1 (126.0.6478.127) |

| [Brave](https://brave.com/download/) | 1.67.123 (126.0.6478.126) |

| [Chrome](https://www.google.com/chrome/browser-tools/) | 126.0.6478.127 (126.0.0.0) |

| [Chromium](https://download-chromium.appspot.com/) | 128.0.6580.0 (128.0.0.0) |

| [Opera](https://www.opera.com/download) | 111.0.5168.61 (125.0.6422.143) |

| [Vivaldi](https://vivaldi.com/download/) | 6.8.3381.46 (126.0.0.0) |

##### *Other*

| Browser | Requires |

|:--------|:---------|

| [Firefox](https://www.mozilla.org/en-US/firefox/all/#product-desktop-release) | 127.0.2 |

| [Safari](https://www.apple.com/safari/) | Doesn't work natively with Safari, but the [Tampermonkey®](https://www.tampermonkey.net/index.php?browser=safari&locale=en) extension (Safari v6-11) or the paid [Mac App Store version](https://apps.apple.com/us/app/tampermonkey/id1482490089) (Safari v12+) could work. I have not tested either, though. |

## Installation

*Not added to the Chrome Web store or Firefox Add-ons yet, but may be in the future.*

##### Browser Extension (manual):

1. Clone this repository or download the [ZIP](https://github.com/956MB/reddit-download-button/releases) file and extract it

2. Open your Chromium-based browser and navigate to the extensions page (e.g., `chrome://extensions`)

3. Enable "Developer mode" in the top right corner

4. Click "Load unpacked" and select the directory containing the extension files

5. The extension should now be installed and active

##### Userscript (Greasyfork/Tampermonkey):

1. Install [Tampermonkey](https://www.tampermonkey.net/) for your browser

2. Click on this link to open the script in Tampermonkey: [Reddit Download Button Script](https://greasyfork.org/en/scripts/501718-reddit-image-downloader)

3. Click on the "Install" or "Update" button

4. The script should now be active on Reddit

## TODO

- [ ] Figure out downloading m3u8 videos

- [ ] ZIP download option for multiple images

- [ ] Add UI for extension settings

## Changelog

[1.2.1](./CHANGELOG.md#121---2024-09-27) - 2024-09-27

##### Fixed

- Fixed issue where single image downloads from inside gallery carousel would not work. Reddit seems to have remove the `tabindex` attribute from the li elements in the gallery carousel, which was used to identify the selected image. We now check if the li has style `visibility: visible` to get the correct indexed image.

For a full list of changes and past versions, please see the [CHANGELOG.md](CHANGELOG.md)

## License

[MIT LICENSE](./LICENSE)