Adds a download button to Bluesky images and videos.
A powerful userscript for bsky.app that adds seamless download functionality for images and videos. Designed for Tampermonkey or Violentmonkey.
Note: This script is NOT compatible with Greasemonkey.
.zip file (enable in Settings).MutationObserver to efficiently detect new posts without slowing down your browser.You can customize how files are named by accessing the Settings menu.
/settings/account).Use these placeholders in your pattern string to dynamically generate filenames:
| Tag | Description | Example Output |
|---|---|---|
<%uname> |
Short username (handle) | oh8 |
<%username> |
Full username | oh8.bsky.social |
<%handle> |
Short for .bsky.social, full for custom domains | oh8 |
<%display_name> |
Display name | Oh Eight |
<%post_id> |
The unique Post ID | 3krmccyl4722w |
<%post_time> |
Timestamp of when the post was created | 1715347800000 |
<%timestamp> |
Timestamp of when you downloaded it | 1550557810891 |
<%img_num> |
The index of the image in the post (0-3) | 0 |
<%title> |
Alt text / Image description | A cute cat |
<%width> |
Original width in pixels | 1920 |
<%height> |
Original height in pixels | 1080 |
<%original_ext> |
Original file format | png |
Default Pattern:
@<%username>-bsky-<%post_id>-<%img_num>
Result:
@oh8.bsky.social-bsky-3krmccyl4722w-0.jpg
Chronological Order (Download Time):
<%timestamp>_<%username>_<%post_id>
Result:
1550557810891_oh8.bsky.social_3krmccyl4722w.jpg
With Display Name and Dimensions:
<%display_name>-<%post_id>-<%img_num>-<%width>x<%height>
Result:
Oh Eight-3krmccyl4722w-0-1920x1080.jpg