https://github.com/956mb/reddit-download-button
Adds buttons to more easily hoard images/videos from Reddit
https://github.com/956mb/reddit-download-button
datahoarder downloader extension greasyfork images javascript post reddit tampermonkey
Last synced: about 1 year ago
JSON representation
Adds buttons to more easily hoard images/videos from Reddit
- Host: GitHub
- URL: https://github.com/956mb/reddit-download-button
- Owner: 956MB
- License: mit
- Created: 2024-07-25T00:45:11.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-02T12:11:06.000Z (over 1 year ago)
- Last Synced: 2025-04-15T00:44:51.869Z (about 1 year ago)
- Topics: datahoarder, downloader, extension, greasyfork, images, javascript, post, reddit, tampermonkey
- Language: JavaScript
- Homepage: https://greasyfork.org/en/scripts/501718-reddit-image-downloader
- Size: 368 KB
- Stars: 9
- Watchers: 1
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Reddit Download Buttons
[](https://greasyfork.org/en/scripts/501718-reddit-image-downloader) [](https://greasyfork.org/en/scripts/501718-reddit-image-downloader) [](https://greasyfork.org/en/scripts/501718-reddit-image-downloader) [](https://opensource.org/licenses/MIT)
The browser extension that I've always wanted for Reddit... download buttons for easily saving images within posts. It's exactly what a data hoarder needs! *Does not require Reddit login.*
## Features
- Adds buttons to Reddit posts and inside galleries for easy one-click downloads
- Separate ZIP download button for downloading all images in a folder
- 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 inline videos due to some `m3u8` thing 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.70.0 (131.0.6778.86) |
| [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 Buttons Script](https://greasyfork.org/en/scripts/501718-reddit-download-buttons)
3. Click on the "Install" or "Update" button
4. The script should now be active on Reddit
## TODO
- [ ] Support 'Old' Reddit / Reddit Enhancement Suite
- [ ] Figure out downloading m3u8 videos
- [X] ZIP download option for multiple images
- [ ] Add UI for extension settings
- [ ] Include metadata in ZIP file for the downloaded images/post (title, author, comments, etc.)
- [ ] Support downloading multiple inline images/videos from text posts
- [ ] Add download buttons to single images in comment sections and ones opened in new tabs.
## Known Issues
> [!NOTE]
> This seems to be fixed now (2025-01-08), I guess it was just a bug with Reddit itself? The button should now download individual images in the gallery carousel as intended.
- ~~For some reason the gallery-carousel on Reddit is keeping all the images as visible ("visibility: visible") when clicking forward/back. This is causing all images up to the index you've clicked to be downloaded. Only other method I can see right now of knowing the index is the translate3d value of the gallery-carousel. It's going up/down based on the window width.~~
- The preview download button doesn't work I believe because of the CORS policy.
- ZIP file creation not working when run from Tampermonkey. [Issue #2](https://github.com/956MB/reddit-download-button/issues/2)
## Changelog
[1.3.4](./CHANGELOG.md#134---2025-01-08) - 2025-01-08
##### Fixed
- Fixed issue where the download button wasn't being added to the post container because the classes of the div were changed. We now look for `div.shreddit-post-container` to make sure we have a place to insert the button.
For a full list of changes and past versions, please see the [CHANGELOG.md](CHANGELOG.md)
## License
[MIT LICENSE](./LICENSE)