/resources

rpcfetch resources

This is the resources repository for rpcfetch

Collection of operating systems, Linux distros, window managers and other applications with their icons.

Usage

This use this in your own projects, you'll need to get the resources.json file.

To download the latest release programmatically, use the GitHub releases API: https://api.github.com/repos/rpcfetch/resources/releases/latest (docs: https://docs.github.com/en/rest/releases/releases#get-the-latest-release)

If you want to add or request new icons, see #contributing.

File structure

resources.json consists of:

  1. The current version (semver)
  2. Categories:
    • app
    • os
    • wm

Each category is a list of resource items.

Resource item definition

Field name Type Default value Description
pattern string (required) Pattern to match
regex boolean false Treat pattern as a Perl 5 compatible regex
icase boolean false Ignore case (does not require regex)
image string (required) Image URL

Discord limitations

  • supports image URLs with a maximum size of 128 bytes
  • supported image formats: PNG, JPEG, WEBP, GIF (this is the only animated format client-side)
  • images other than 1:1 aspect ratios are stretched on desktop
  • images are fully rounded
  • images should have enough contrast (or a background color) to stand out against the dark theme background: #111214 and the light theme background: #ffffff

Examples of valid resource items

Name must match dwm:

{
  "pattern": "dwm",
  "image": "https://raw.githubusercontent.com/rpcfetch/resources/main/assets/wm/dwm.png"
}

Name must match firefox but the case can be ignored:

{
  "pattern": "firefox",
  "icase": true,
  "image": "https://raw.githubusercontent.com/rpcfetch/resources/main/assets/app/firefox.png"
}

Name must match the regex ^Arch( Linux)?$:

{
  "pattern": "^Arch( Linux)?$",
  "regex": true,
  "image": "https://raw.githubusercontent.com/rpcfetch/resources/main/assets/os/archlinux.png"
}

Repository structure

In the assets folder there are folders of applications, operating systems (and Linux distros), window managers: assets/app, assets/os, assets/wm

An example of Firefox would look like this: assets/app/firefox.png

Legal

Disclaimer: The icons and images contained in this repository may be subject to copyright protection, and I want to clarify that I do not claim any ownership rights to them.

Contact the public email of this GitHub organization to request the removal of images.

Contributing

If you want to request icons, open an issue with the names you want.

Feel free to submit pull requests with your desired additions or changes to help this project support the applications you use. If you want to add images to this repository, please make sure that they are compatible with the limitations of Discord.

Do not use "unofficial" application icons.