PK[CHKimg]

Created by SPEARHEADRAMPANCY.sys (ToraNine09#8501)

Version 99.99z - 99/Null/9999

Return to site home page


Page Themes & Accessibility

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


[V1.6] ~ Fixed system ID format check explictly only accepting abcde and abcdef. All formats should now work
[V1.6] ~ Fixed "finalResults undefined" error in direct URL checking
===========================
[V1.5] = Version 1.4 was made using older versions of some scripts, which reintroduced some bugs and bad code. Version 1.5 fixes those bugs while keeping the features/fixes from Version 1.4.
[V1.5] ~ Fixed some tokens resulting in an "invalid token format" error, due to test match code being reintroduced
[V1.5] - Removed alpha-branch error handling code
[V1.5] ~ Improvements to reimplemented live-branch error handling code
[V1.5] + Added specific pre-check for blank token
[V1.5] + Added specific pre-check for blank system ID
[V1.5] ~ Fixed results filtering button groups having no header formatting
[V1.5] ~ Fixed results filtering not initialising on load
[V1.5] ~ Fixed results filtering buttons having underlined emojis
[V1.5] ~ Clarified results filter button text
[V1.5] ~ Fixed the button to show explanation of URL queries
===========================
[V1.4a] + Enabled TENV while fixing a bug (new version soon!)
===========================
[V1.4] ~ Updated embed text to better reflect current tool function
[V1.4] ~ Improved readability of Results settings buttons using emojis
[V1.4] ~ Fixed direct link detection for URLs containing a query
[V1.4] + Added Discord avatar URL as an acceptable link
[V1.4] ~ Rephrased some parts of FAQ and instructions to make purpose more clear
[V1.4] + Added FAQ about direct links
[V1.4] + Added collapsible sub-sections to FAQ
===========================
[V1.3] ~ Made the tool compatible with 6 letter IDs
===========================
[V1.2] + Implemented result filtering
===========================
[V1.1] + Added link to homepage
[V1.1] ~ Clarified actual tool text
[V1.1] + Implemented globalfunctions
===========================
[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] ~ Changed "About this tool" to Frequently Asked Questions
[V0.5] + Added FAQ navigation
===========================
[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 on sites that aren't Discord (including resources like the PluralKit dashboard and Simply Plural). 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), which will not load anywhere
  • Discord CDN Attachment URLs, which no longer load outside of Discord 24 hours after the URL was copied
  • Discord CDN Avatar URLs, which should load outside of Discord until the original user changes their account avatar
  • PluralKit CDN URLs, which should load everywhere
  • URLs from image hosts that are known to fail, which will fail everywhere
  • URLs from other image hosts, which may or may not load
  • URLs that are not direct links to images, which will not load anywhere

The following are planned for future updates:

  • Actively checking links for current validity, such as:
    • 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
  • Checking if proxy images use an animated format (such as .gif), which will result in a static image when proxied

Return to top

What counts as a direct image link?

For most sites to be able to use the link properly, the image link must end with either a file extension (the supported extensions are .png, .jpg, .jpeg, .gif, or .webp), or a file extension followed by a query such as for size (eg: .png?size=50x50).

What is a "query" in a link?

Return to top

Why was the tool made?

Beginning in 2023, Discord started making changes which meant that message attachments that were uploaded directly to Discord before sending could no longer be linked to outside of Discord 24 hours after the URL was copied. 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.

Ultimately, this tool is only designed for diagnosing whether an image should be expected to load outside of Discord.

Return to top

Why does the tool say that an image "should load" but it doesn't load...?

... On a site that isn't Discord?

Short answer: Currently, this tool only checks for "static" known reasons why the image may or may not work. It doesn't check for "dynamic" issues, as in things that might be affecting the avatar only from time to time. If a temporary or very new problem arises, this tool cannot check in "real time" to see that.

Show long answer

If this tool reports that an image should load outside of Discord but you find that it doesn't, please let me know so I can investigate.


... In Discord specifically?

Short answer: It's most likely a Discord loading issue, but this tool isn't for checking for issues with images loading within Discord.

Show long answer

If an image that this tool marks as "should load" isn't loading in Discord, it is most likely an issue with Discord itself.



Return to top

Why does the tool say that an image "will not load" but it does...?

... On a site that isn't Discord?

Sorry for the confusion! This is likely due to changes on the file host's end.

If the tool says an image should not load but it does, please let me know so I can investigate. I may need to update this tool.


... In Discord specifically?

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.

If the tool reports that an image will not load outside of Discord but you find that 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 (source). They strongly prefer that you don't use Neocities as a "file hosting service" even if you have their "Supporter" plan.

Return to top

How do I use this tool?

Enter your 64 character PluralKit API Token, and 5 or 6 character PluralKit System ID (Allowed formats are abcde, abcdef, abc-def with or without capital letters) 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 token, make sure that you have exactly 64 characters copied, with no spaces before or after. Some devices may 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 image 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 below the status section.

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:

At first, the results below will only display the system avatar and banner. This is done to reduce the chance of lag for large systems. Please use the filter options below to view the rest of the results.

When the tool has finished running, you will receive the final list of results here.