PK[CHKimg]

Created by SPEARHEADRAMPANCY.sys (ToraNine09#8501)

Version 1.2 - 30/03/2024

Return to site home page


Page Themes & Accessibility

NOTE: Page themes do not persist between pages or sessions.


[V1.2] + Implemented result filtering
===========================
[V1.1] + Added link to homepage
[V1.1] ~ Clarified actual tool text
[V1.1] + Tool now uses globalfunctions properly
===========================
[V1.0] + Added dark/light theme switcher
===========================
[V0.9] ~ Clarified entire FAQ
[V0.9] ~ Made reasons more verbose
[V0.9] + Added check for direct links
[V0.9] + Added check for hosts that are known to fail
===========================
[V0.8] ~ Clarified current features
[V0.8] + Added disclaimer about Discord media cache failures
[V0.8] ~ Minor changes to wording
[V0.8] ~ Further page formatting changes
[V0.8] ~ Results format changed for accessibilty reasons
===========================
[V0.7] - Temporarily removed result view settings (pending rework)
[V0.7] + Results generator finished
===========================
[V0.6] + Added result view settings buttons
[V0.6] + Fixed issues with interim result generation
[V0.6] ~ Minor page formatting changes
===========================
[V0.5] + Added FAQ navigation
[V0.5] ~ Changed "About this tool" to Frequently Asked Questions
===========================
[V0.4] - Removed verbose log due to it crashing browsers
[V0.4] ~ Improved processing delay
===========================
[V0.3] + Added null check before Discord CDN check
===========================
[V0.2] ~ Changed token field properties to discourage saving in browser
===========================
[V0.1] + Tool framework completed


Frequently Asked Questions

Hide FAQ

What is this tool for?

PK[CHKimg] is short for PluralKit[Check Image].

This tool checks your PluralKit system for member, group, or system images and provides a list of what is or isn't likely to load outside of Discord (including the PluralKit dashboard). This tool checks system avatars, system banners, member avatars, member proxy avatars (AKA "webhook avatars"), member banners, group avatars (AKA "icons"), and group banners. This tool does not detect invalid Discord emotes in member/group/system descriptions.

This tool does not update broken images. It only provides you with a list of what may or may not load.


What does this tool detect?

This tool detects the following:

  • URLs that are null (empty, not set)
  • Discord CDN URLs, which no longer work outside of Discord after 24 hours
  • Pluralkit CDN URLs, which should load
  • URLs from image hosts that are known to fail
  • URLs from other image hosts, which may or may not load
  • URLs that are not direct links to images (links must end with exactly .png, .jpg, .jpeg, .gif, or .webp), which will not load

The following are planned for a future update:

  • HTML 404 errors indicating the file no longer exists at the source
  • HTML 403 errors indicating a file may still exist at the source, but third party services are forbidden from accessing it
  • HTML 429 errors indicating a host is ratelimiting and preventing the file from being accessed
  • Other errors which indicate that the file cannot be accessed for another reason

A future update may also allow the tool to detect if a .gif file is used as a member's proxied avatar (this can be either a proxy avatar or a regular avatar), because Discord does not allow webhooks to have GIF avatars, but this is not currently a priority.

Return to top

Why was the tool made?

Discord recently made changes which meant that files uploaded to the Discord CDN (which is what happens when you upload a file to Discord) could no longer be linked to outside of Discord 24 hours after the file was originally uploaded. The PluralKit developers tried to get all avatars moved to their own image hosting solution, but some were missed. As a result, some images may break on external sites and this might not be immediately obvious when viewing the system in Discord.

Additionally, some images do spontaneously break for other reasons, and this can be annoying to manually check.

Return to top

Your tool suggests that an image should load but it doesn't (in Discord)!

This tool cannot determine if Discord itself is currently having issues with loading images, which is a common cause of PluralKit proxy images not loading. Images are determined as "should load" if there are no known reasons why the image will not load correctly - eg: being hosted on Discord's CDN (the image will not load outside of Discord), being hosted on a host that actively prevents hotlinking (the image will not load at all).

If the image loads on the PluralKit dashboard or another non-Discord platform, but not within Discord, then it is likely a Discord-specific issue. You can check Discord's status page to see if they've logged the issue, but be warned that not all webhook media issues are reported on that site.

If you're having issues with an image that this tool marks as "should load" and Discord is not having issues with webhook images, image caching, or its media proxy in general, please let me know so I can investigate.

Return to top

Your tool suggests that an image should load but it doesn't (outside of Discord)!

At the moment, this tool does not check images for current problems that might impact whether the image loads. Possible reasons the tool reports that the image should be fine, but it doesn't actually load: the file has been deleted or expired, the host site is down, the host site is ratelimiting. You can check for the first two issues yourself by copying the image url and opening it in your browser. You can usually also check the image host's website to see if they are reporting any problems. Ratelimiting means the host site is getting too many requests from a source. If this happens, you can either wait for this to resolve itself, or find a new host.

It's also possible the host has made some change that prevents other services from loading the image, such as disabling hotlinking (direct links to the image) or forcing authentication in order to see an image. If this is the case, I'll need to update the tool to reflect this new behaviour.

If you're having issues with an image that this tool marks as "should load" and you can view the image when you visit the image link in your browser, please let me know so I can investigate.

Return to top

Your tool states an image will not load but it does (in Discord)!

This is intentional behaviour. This tool's purpose is to determine whether an image will load outside of Discord, such as on the PluralKit dashboard or another non-Discord platform.
Discord CDN links will still load within Discord, unless Discord happens to be experiencing an outage.

If the image isn't a Discord CDN link, the tool says it should not load, but it does, please let me know so I can investigate.

Return to top

Your tool states an image will not load but it does (outside of Discord)!

Sorry for the confusion! This is likely due to changes on the host's end. If the tool says an image should not load but it does, please let me know so I can investigate.

Return to top

Why do Neocities links get marked as "will not load"?

Neocities does not like hotlinking. You can upgrade to their paid Supporter plan to remove this restriction, but this tool has no way of detecting if you have that plan. They strongly prefer that you don't use Neocities as a "file hosting service" either way.

Return to top

How do I use this tool?

Enter your 64 alphanumeric character API Token, and 5 letter System ID in the boxes below and click on the "Go" button. You can get your system's API token by running the command pk;token in the PluralKit bot. When copying the code, make sure that you have exactly 64 alphanumeric (letters and numbers only) characters copied, with no spaces before or after. Some devices will add a space around the text and the tool will not work if these are included in the box below.

Return to top

PK[CHKimg]


This process may take some time - each member can take one to two seconds to process. The status header below will update as it progresses, and the box underneath the status header will provide you with detailed information including error messages. Once complete, you will receieve the final list in the "Results" box.

IMPORTANT: This tool does not make any changes to information stored in PluralKit.

Confirmation:


Status: Not running.

While the tool is running, you will receive progress updates here.


Results:

By default, the results below will only display the results for the system avatar and banner. This is done to prevent lag for large systems. Please use the filter options below to view the rest of the results.

When the tool is finished, you will receive the final list here.