https://github.com/cooksleep/skyfetch-script
Add a download button at the bottom right of BlueSky posts containing images to automatically download the highest resolution images with customizable naming rules.
https://github.com/cooksleep/skyfetch-script
bluesky browser-extension download-manager greasemonkey i18n image-downloader javascript social-media tampermonkey userscript
Last synced: 11 months ago
JSON representation
Add a download button at the bottom right of BlueSky posts containing images to automatically download the highest resolution images with customizable naming rules.
- Host: GitHub
- URL: https://github.com/cooksleep/skyfetch-script
- Owner: CookSleep
- License: gpl-3.0
- Created: 2024-11-10T13:30:28.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-20T18:59:54.000Z (about 1 year ago)
- Last Synced: 2025-01-20T19:38:05.732Z (about 1 year ago)
- Topics: bluesky, browser-extension, download-manager, greasemonkey, i18n, image-downloader, javascript, social-media, tampermonkey, userscript
- Language: JavaScript
- Homepage:
- Size: 651 KB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
SkyFetch
A Tampermonkey script that adds a download button to BlueSky posts containing images, allowing you to download the highest resolution version with customizable naming rules.
Supports multiple languages (English, Chinese, Japanese, Korean, Russian).
The code for this project was primarily written by `OpenAI o1-mini`, `claude-3.5-sonnet` and `chatgpt-4o-latest`, with numerous style and functionality design suggestions and feedback provided by me.
This project also uses the download button SVG from the [Twitter Media Downloader](https://greasyfork.org/es/scripts/423001-twitter-media-downloader) project, which is licensed under the [MIT License](https://opensource.org/licenses/MIT).
> BlueSky_Bluesky_@bsky.app_2024-09-17_1_1o2i.jpg
> BlueSky_Username_ID_ImagePublicationDate_ImageNumber_RandomIdentifier.jpg
## Features
- Adds a download button to posts containing images
- Automatic construction of high-resolution image links
- Downloads highest resolution version of images automatically (BlueSky platform limits to .jpg format)
- Automatic addition of image metadata to filenames
- Customizable file naming rules
- Supports multiple languages (English, Chinese, Japanese, Korean, Russian)
- Dark/Light mode support
- Local data processing to protect user privacy
- Settings panel for customization
## Installation
1. Install [Tampermonkey](https://www.tampermonkey.net/) browser extension
2. Visit [SkyFetch Script](https://github.com/CookSleep/SkyFetch-Script/raw/main/SkyFetch-Script.user.js)
3. Click "Install" in Tampermonkey
> For users of the Tampermonkey extension based on Chrome browsers, enabling developer mode is a necessary condition introduced by the Manifest V3 update. You need to enable developer mode in the browser's extension settings page, otherwise the script will not work at all!
## How to Use
1. Browse BlueSky normally
2. When you see a post with images, click the download button in the bottom right
3. The image(s) will be downloaded automatically in highest resolution
4. Access settings through Tampermonkey menu to customize file naming
## Contributing
Contributions to the project are welcome! If you have any suggestions or want to add new features, feel free to create an Issue or Pull Request.
## License
This project is licensed under the [GNU General Public License v3.0](https://www.gnu.org/licenses/gpl-3.0.html). See the [LICENSE](LICENSE) file for details.