Topic: PSA: Obtaining higher-quality images from Bluesky sources & adding Bluesky permalinks

Bluesky serves two types of sample versions: feed_thumbnail and feed_fullsize. These are not the best public versions on the site. In order to access higher-quality versions, you need to reformat the URL to retrieve the original blob instead. Additionally, Bluesky uses a format for accounts and posts that breaks when usernames are changed. Solving these issues requires changing the URL to include the user's DID (decentralized identifier), but performing this process manually is tedious.

The two userscripts below will automatically get the best image quality and resolve to more stable links to Bluesky account and post pages:

Bluesky higher-quality image redirect: https://gist.github.com/Tarrgon/a58375cd3c1f15d8fd4238a2a7df35b5
Bluesky stable links redirect: https://gist.github.com/Tarrgon/c84f267a4f97314090b4870760b8fb8f

In order to use these, you will need a userscript manager. An example of a userscript manager is Tampermonkey: https://www.tampermonkey.net/

Once you install a userscript manager extension of your choice, copy-paste the scripts linked above into new scripts and save. Bluesky image links will now reload to higher-quality versions, and post and account links will be more stable for archiving purposes. The image quality improvement will vary from almost imperceptible to significantly less JPEG compression, but this version will always be superior.

-----

Edit: As of 2026-02-17, this method no longer works for image links without additional steps. Bluesky changed response headers in a way that prevents userscript managers like Tampermonkey from changing.

As a workaround, you will need to download an additional extension. Simple Modify Header is lightweight and works for this purpose.

Firefox add-on: https://addons.mozilla.org/en-US/firefox/addon/simple-modify-header/
Chrome extension: https://chromewebstore.google.com/detail/simple-modify-headers/gjgiipmpldkpbdfjkgofildhapegmmic?pli=1

Once downloaded, copy and save the following into a file named SimpleModifyHeader.conf

{"format_version":"1.2","target_page":"https://*.bsky.network/xrpc/com.atproto.sync.getBlob*","headers":[{"url_contains":"","action":"modify","header_name":"content-disposition","header_value":"inline","comment":"test","apply_on":"res","status":"on"}],"debug_mode":true,"show_comments":true,"use_url_contains":false}

Then, from the extension menu into the toolbar, open the "Configure" option for the extension, click the "Import" button on the top right to import the config, and click the button on the top right to start the extension. Bluesky image link redirects will now work again.

I checked this a few days ago and smiled when I found out only like a 1/5th of bsky posts are sourced from that API endpoint.

Sometimes I wondered if it was possible to add a feature to the upload page to enter the URL of the post and it would extract the best possible image URL associated with the post automatically...

aninox said:
Sometimes I wondered if it was possible to add a feature to the upload page to enter the URL of the post and it would extract the best possible image URL associated with the post automatically...

Danbooru has this but multiple successive e6 devs have denied implementing it due to how complicated it can be to upkeep

Maybe the BlueSky developer should be approached about being able to conveniently retrieve the image file you want to download

nin10dope said:
Maybe the BlueSky developer should be approached about being able to conveniently retrieve the image file you want to download

Like its predecessor Twitter/X or any other social media site, Bluesky is not designed as an art gallery or a file-sharing service.
Everything is compressed to shit and more, and artists should instead be persuaded to post elsewhere if they want to retain their artwork quality.

The setup is quite a bit more complex than installing a simple userscript, but you can also use FoxTrove to scrape the best available versions from Bluesky (and many other sites), then automatically reverse-search each one to identify posts that could potentially be replaced.

thegreatwolfgang said:
Like its predecessor Twitter/X or any other social media site, Bluesky is not designed as an art gallery or a file-sharing service.
Everything is compressed to shit and more, and artists should instead be persuaded to post elsewhere if they want to retain their artwork quality.

Yeahhhh you made me remember Facebook utterly nuking everything posted there
At least Messenger doesn't commit war crimes on images sent through it

Just to make sure I have been doing this right, doing manually like this is still right or is there a new way?

https://bsky.social/xrpc/com.atproto.sync.getBlob?did=(stuff)&cid=(stuff)

For example, taking this link:

https://cdn.bsky.app/img/feed_fullsize/plain/did:plc:3y2b7u5qnwzwibk6o32umgza/bafkreif66mhpe3y5hlbsx2poqka3hf42ygk4q5yasdjwrzunr6ue6nifja@jpeg

And using these parts for each "stuff"

"did:plc:3y2b7u5qnwzwibk6o32umgza"
"bafkreif66mhpe3y5hlbsx2poqka3hf42ygk4q5yasdjwrzunr6ue6nifja" (taking off the "@jpeg")

Sigh, uploading from blusky is really tiring but I really don't want to use tampermonkey or something lol.

notknow said:
Just to make sure I have been doing this right, doing manually like this is still right or is there a new way?

https://bsky.social/xrpc/com.atproto.sync.getBlob?did=(stuff)&cid=(stuff)

For example, taking this link:

https://cdn.bsky.app/img/feed_fullsize/plain/did:plc:3y2b7u5qnwzwibk6o32umgza/bafkreif66mhpe3y5hlbsx2poqka3hf42ygk4q5yasdjwrzunr6ue6nifja@jpeg

And using these parts for each "stuff"

"did:plc:3y2b7u5qnwzwibk6o32umgza"
"bafkreif66mhpe3y5hlbsx2poqka3hf42ygk4q5yasdjwrzunr6ue6nifja" (taking off the "@jpeg")

Sigh, uploading from blusky is really tiring but I really don't want to use tampermonkey or something lol.

I tried that method, all I get is a white screen with "Source image is unreachable" error message.

schlob said:
I tried that method, all I get is a white screen with "Source image is unreachable" error message.

It should look like this:
https://bsky.social/xrpc/com.atproto.sync.getBlob?did=did:plc:3y2b7u5qnwzwibk6o32umgza&cid=bafkreif66mhpe3y5hlbsx2poqka3hf42ygk4q5yasdjwrzunr6ue6nifja
After entering the url it should turn into this:
https://morel.us-east.host.bsky.network/xrpc/com.atproto.sync.getBlob?did=did:plc:3y2b7u5qnwzwibk6o32umgza&cid=bafkreif66mhpe3y5hlbsx2poqka3hf42ygk4q5yasdjwrzunr6ue6nifja

I may have explained it a bit wrong but it works for me lol

Song said:
We now also have a userscript to convert Bluesky account and post pages to use more permanent DID numbers, available here:
https://gist.github.com/Tarrgon/c84f267a4f97314090b4870760b8fb8f

Note for Violentmonkey users: Unlike Tampermonkey, Violentmonkey requires that access to GM.getValue and GM.setValue be @Granted explicitly, rather than being included under GM_getValue and GM_setValue.

Hi Song, I noticed some of the pictures I uploaded (from suitedwolfie) got replaced using this script. I understand that we want to host the higher quality version available, but at the same time my upload limit was reduced due to the replacements.
This is the first time I tried uploading images to e6 and I wasn't aware of this script's existence (I didn't check the forum). I was uploading those because I noticed that no one else was uploading this artist's recent comic pages.

I can't help but feel like I'm getting unfairly penalized through these replacements, even though I tried to help by uploading them here. Is there no way to replace images on e6 without punishing the previous uploader?

nyaaaaa said:
Hi Song, I noticed some of the pictures I uploaded (from suitedwolfie) got replaced using this script. I understand that we want to host the higher quality version available, but at the same time my upload limit was reduced due to the replacements.
This is the first time I tried uploading images to e6 and I wasn't aware of this script's existence (I didn't check the forum). I was uploading those because I noticed that no one else was uploading this artist's recent comic pages.

I can't help but feel like I'm getting unfairly penalized through these replacements, even though I tried to help by uploading them here. Is there no way to replace images on e6 without punishing the previous uploader?

The uploading limit penalty exists to ensure users post content that meets the Uploading Guidelines and that they do not upload sample versions, which can create more work for site staff and users by needing to replace them later. To encourage uploading the best versions, replacements by default penalize the user unless that user is replacing their own uploads, but they can be flipped to not penalize on a case-by-case basis if something is truly outside of that user's control. I would not worry too much about this number - we don't think any less of you, and it's not going to hurt your account in the long run to have some posts deleted or replaced. You can still upload 8 posts an hour, will see that rise back over time, and are now equipped with more information to avoid post replacements in the future. We also want to keep this system transparent, rather than relying on opaque posting limits or activity throttling like major websites, even though it can be discouraging seeing a number go down.

In the case of flags or replacements when a user uploads samples, we do bring up cases where a user's upload limit is slashed excessively for reasons outside their reasonable knowledge or control. We are not going to leave a user at 0 or some other very low number because they didn't happen to read the forum or site wiki about sources, as there is no reasonable expectation that they would be aware of these resources. We manually bump those up back to some recoverable default, such as 5 or 10, and users can also make requests to staff if we forget to do so. User contributions are appreciated and wanted, even if they miss something due to not knowing the ins-and-outs of every website, and we're not going to be draconian about it.

Nothing is ever simple 🙄

Also see https://danielmangum.com/posts/this-website-is-hosted-on-bluesky/ for details on how Bluesky content addressing works.

I whipped up a tiny webpage for converting cdn.bsky.app URLs to the correct https://bsky.social/xrpc/com.atproto.sync.getBlob?did=<User DID>&cid=<Content CID> format:

Source Code:

<!DOCTYPE html>
<input id="input"></input>
<button onclick="convert()">Convert</button><br>
<a id="output"></a>
<script>
let input = document.getElementById('input');
let output = document.getElementById('output');
function convert() {
    let src = input.value;
    let arr = src.split("/");
    for (i = 0; i < arr.length; i++) {
        if (arr[i].startsWith("did:")) {
            let did = arr[i + 0];
            let cid = arr[i + 1].split("@")[0];
            let fmt = "https://bsky.social/xrpc/com.atproto.sync.getBlob?did=" + did + "&cid=" + cid;
            output.innerHTML = fmt;
            output.href = fmt;
            return;            
        }
    }
}
</script>

how does the Github script work, exactly?

0f8c4c9d05154171ae8 said:
I whipped up a tiny webpage for converting cdn.bsky.app URLs to the correct https://bsky.social/xrpc/com.atproto.sync.getBlob?did=<User DID>&cid=<Content CID> format:

What's the point of that when you can just use the userscript which will redirect you with the only needed input being opening the image in a new tab

istole50watermelons said:
how does the Github script work, exactly?

It grabs parts of the url and reconstructs them into a url which resolves to the highest quality image bluesky can provide

donovan_dmc said:
What's the point of that when you can just use the userscript which will redirect you with the only needed input being opening the image in a new tab

Friction matters.

Even though the instructions for setting up user scripts are provided and not really hard, it’s still a turn off for those who might otherwise have helped with a quick one-off edit but not if they have to go through the extra hassle. Having a quick webpage they could just open immensely reduces that friction. Or even just a short, explicit instruction for how to convert it manually without setup, is conducive to motivating such drive-by edits.

Crowdsourcing efforts generally should encourage good-faith drive-by contributions instead of selecting only for those intending to dedicate time (the pool of which may or may not include obsessive bad-faith actors).

I just tried using the redirect userscript on the following post, just to test it, and it did not work. https://bsky.app/profile/hijibbles.bsky.social/post/3logrgzpwjs2o
Not even doing the URL substitutions manually got me anything useful. (from https://cdn.bsky.app/img/feed_fullsize/plain/did:plc:p7zf4b3t6dqrkm3l4z4ywuc5/bafkreieq2b6iqsi5ecxm5o5wbfpkf6s7jo7xqzxb2ulictygdqylv2rn44@jpeg to https://bsky.social/xrpc/com.atproto.sync.getBlob?did=did:plc:p7zf4b3t6dqrkm3l4z4ywuc5&cid=bafkreieq2b6iqsi5ecxm5o5wbfpkf6s7jo7xqzxb2ulictygdqylv2rn44)

I received the following JSON instead:

{"error":"InvalidRequest","message":"Error: Params must have the property \"cid\""}

The URL in my browser immediately throws out the "&cid=..." part. Maybe the Bluesky server is redirecting me?

ichhabs said:
I just tried using the redirect userscript on the following post, just to test it, and it did not work. https://bsky.app/profile/hijibbles.bsky.social/post/3logrgzpwjs2o
Not even doing the URL substitutions manually got me anything useful. (from https://cdn.bsky.app/img/feed_fullsize/plain/did:plc:p7zf4b3t6dqrkm3l4z4ywuc5/bafkreieq2b6iqsi5ecxm5o5wbfpkf6s7jo7xqzxb2ulictygdqylv2rn44@jpeg to https://bsky.social/xrpc/com.atproto.sync.getBlob?did=did:plc:p7zf4b3t6dqrkm3l4z4ywuc5&cid=bafkreieq2b6iqsi5ecxm5o5wbfpkf6s7jo7xqzxb2ulictygdqylv2rn44)

I received the following JSON instead:

{"error":"InvalidRequest","message":"Error: Params must have the property \"cid\""}

The URL in my browser immediately throws out the "&cid=..." part. Maybe the Bluesky server is redirecting me?

Your link works fine on my end. Perhaps disable the userscript before testing the link?

By the way, there's a far simpler way of getting the user's DID from its handle: just go to https://<USER HANDLE>/.well-known/atproto-did

0f8c4c9d05154171ae8 said:
By the way, there's a far simpler way of getting the user's DID from its handle: just go to https://<USER HANDLE>/.well-known/atproto-did

This won't work for the many users that have custom domains as handles

0f8c4c9d05154171ae8 said:
By the way, there's a far simpler way of getting the user's DID from its handle: just go to https://<USER HANDLE>/.well-known/atproto-did

Sorry, could you write an example using that link? I couldn't make it work on my end.

notknow said:
Sorry, could you write an example using that link? I couldn't make it work on my end.

https://hijibbles.bsky.social/.well-known/atproto-did

Yep it worked, I forgot the "bsky.social" part welp

https://shiiiiiiiva.bsky.social/.well-known/atproto-did
did:plc:4lwjijzjv2tulzc22w4rvm3o

Edit: Also used the small webpage code and it worked for me, less work than doing what I was doing manually copying and pasting the two IDs and having to cut off the "@JPEG" every time lol, thanks.

No I don't want to use tampermonkey.

Can the userscripts be rewritten as simple bookmarklets? Especially the first script seems simple enough that adding the following as a bookmark should just work:

javascript:(async function () { 'use strict'; let url = window.location.pathname.split("/"); if (url.length < 6) return; let did = url[4]; let cid = url[5].slice(0, url[5].lastIndexOf("@")); if (did && cid) { window.location.href = `https://bsky.social/xrpc/com.atproto.sync.getBlob?did=${did}&cid=${cid}`; } })();

0f8c4c9d05154171ae8 said:
Your link works fine on my end. Perhaps disable the userscript before testing the link?

I did, of course.

I did some testing and found the issue: I have a Firefox Add-on called Neat URL that is supposed to remove bullshit tracking data from URLs, but it gets triggered by the "cid" parameter. In the settings, it's simply marked as "Campaign tracking (others)". I have added it to the override list, which fixed the problem. If I ever encounter a cid parameter in the wild, I will have to add a domain-specific block rule.

donovan_dmc said:
What's the point of that when you can just use the userscript which will redirect you with the only needed input being opening the image in a new tab

It grabs parts of the url and reconstructs them into a url which resolves to the highest quality image bluesky can provide

sorry to ask, but i genuinely do not know how to use the script

what am i supposed to do exactly for it to work?

istole50watermelons said:
sorry to ask, but i genuinely do not know how to use the script

what am i supposed to do exactly for it to work?

1) Download a userscript manager (in this case Tampermonkey, linked in the original post)
2) Go to your extensions manager page and open the options for Tampermonkey
3) Click the + icon to add a new script
4) Clear the template and copy-paste one of the scripts into it exactly
5) Hit File -> Save in the top left
6) Repeat steps 3-5 for the second script linked in the first post

That is it. Once installed, userscripts work automatically and can be completely forgotten about while you browse. Extensions like userscript managers will be disabled in private browser windows by default, but you can change this behavior if you want to from your browser's extensions menu.

I hope this explanation was clear for you! If you have any other questions, feel free to ask.

Same can be done for videos but with considerably more verbose steps.

Open dev tools, click on a post, then find the request to endpoint
/xrpc/app.bsky.unspecced.getPostThreadV2
You can find did in the response. Path:
thread[0].value.post.author.did
(did:plc: must be prepended to value)
and cid:
thread[0].value.post.embed.cid
Substitute parameters: https://bsky.social/xrpc/com.atproto.sync.getBlob?did=${did}&cid=${cid}. This is the same as the images.

As https://e621.net/wiki_pages/howto:sites_and_sources mentioned:
Videos are compressed to 1080p resolution (720p before July 2025) at 30 fps in MP4 format, regardless of its original dimensions(?), and are limited to 3 minutes at most as of March 2025 (before this, the limit was 60 seconds)

Well shit, i've posted multiple Bluesky images and this kept grinding my gears. I didn't realize that there was a solution.
Honestly i'll prefer to upload from FurAffinity where possible, i agree with the previous comment that Bluesky isn't meant as an art gallery at all

Bluesky recently changed response headers for image links, breaking functionality. The original post has been updated with additional steps for working around this to continue to redirect to higher-quality images.

song said:
Bluesky recently changed response headers for image links, breaking functionality. The original post has been updated with additional steps for working around this to continue to redirect to higher-quality images.

Thank you for the update 🙏
I thought I broke something when it was no longer working but lo and behold there's already a fix.

Once downloaded, copy and save the following into a file named SimpleModifyHeader.conf

Into "a file?" what kind of file? a text file?

yiff_connoisseur said:
Into "a file?" what kind of file? a text file?

Basically, although instead of the file ending in .txt it'll end in .conf, just copy/paste into notepad or your text editor of choice. Then when saving you can copy/paste that whole filename (or type something else and end it with .conf.)

The extension that Song linked just looks specifically for files with the .conf extension by default, but it still works if you tell it to use a text file instead.

I don't see this mentioned here, so I think I can mention that there is a way to get the DID without using extensions, extra scripts, or anything like that.
If you click on the share button on a BSky post, and click the option "Embed post", you can find the DID link of the post within the embed code that it gives you, on the last <a href> link.
For example, going to this post on the BSky account:

https://bsky.app/profile/bsky.app/post/3l6oveex3ii2l

Then copying the code given by the Embed post option, the last <a href> tag of the code contains this link:

https://bsky.app/profile/did:plc:z72i7hdynmk6r22z27h6tvur/post/3l6oveex3ii2l

It is a bit of an extra step going through the embed code to find that link, but at least you only need to paste it into Notepad and grab the link, without having to install anything else

all this to get a link lol. better update for blusky. allow picture to go past 2000 res and load full quality by default. just love these sites... alright, well glad there was a fix.

Did everything, still having trouble...

I followed the instructions in the OP for Chrome (simple-modify-headers plus the Tarragon userscripts), but when I visit an image URL like

https://cdn.bsky.app/img/feed_fullsize/plain/did:plc:ozqkkggrcvredg32cwzbwnun/bafkreih74gg3yrycweaeb2m26rorschrkcqnwka4aqivoizbgql566dfxu

it redirects to

https://bsky.social/xrpc/com.atproto.sync.getBlob?did=did:plc:ozqkkggrcvredg32cwzbwnun&cid=bafkreih74gg3yrycweaeb2m26rorschrkcqnwka4aqivoizbgql566dfx

and gives the error

{"error":"InvalidRequest","message":"Error: cid must be a cid string"}

imfac said:
...

That's annoying. The userscript is truncating the cid by one character because it's not finding an @ and slicing before index -1. This can be fixed by replacing the line

let cid = url[5].slice(0, url[5].lastIndexOf("@"))

with

const cid_at_idx = url[5].lastIndexOf("@");
let cid = cid_at_idx === -1 ? url[5] : url[5].slice(0, cid_at_idx);

imfac said:
That's annoying. The userscript is truncating the cid by one character because it's not finding an @ and slicing before index -1. This can be fixed by replacing the line

let cid = url[5].slice(0, url[5].lastIndexOf("@"))

with

const cid_at_idx = url[5].lastIndexOf("@");
let cid = cid_at_idx === -1 ? url[5] : url[5].slice(0, cid_at_idx);

Thank you for the report and fix suggestion. Tarrgon updated the script at the source, so you can update your script if you encounter this issue.

So, I've updated my script, but now it doesn't redirect to the:

"oyster.us-east.bsky"
"inkcap.us-east.bsky"
"porcini.us-east.bsky"...etc, URLs.

They redirect to "cdn.bsky.app/img/feed_fullsize/plain/" URLs with WEBP-formatted pictures.

Are the images that the script redirects to still valid to post?

kazuoichigama said:
So, I've updated my script, but now it doesn't redirect to the:

"oyster.us-east.bsky"
"inkcap.us-east.bsky"
"porcini.us-east.bsky"...etc, URLs.

They redirect to "cdn.bsky.app/img/feed_fullsize/plain/" URLs with WEBP-formatted pictures...

Ditto to this. Clicked "Save" then "Start" and I did not see a change.

I notice the pattern is

https://*.bsky.network/xrpc/com.atproto.sync.getBlob*

In the script, is that supposed to be the end result (once the Modify Header is ran), or what it expects to start to modify the URL? If it is the latter, that is not working since it is landing on the

https://cdn.bsky.app/img/feed_fullsize...

(I also modified my TamperMonkey with the new recommendation to fix the CID error)

The other oddity I've encountered is that the pictures on the URLs that the browser lands on seem to be high-quality, enough for it to be accepted. I did a test with one picture a few days ago, and it seemed to be accepted yesterday: https://e621.net/posts/6259383

Anyone else (aside from SuperSaltman and KazuoIchigama) no longer getting results from Simple Modify Header? Is there a workaround for the workaround in the works around here?

gattonero2001 said:
Is there a workaround for the workaround in the works around here?

My head hurt just reading that. XD