Skip to content
Levi edited this page Nov 14, 2025 · 3 revisions

Just a couple of booleans to enable images

Enable Images

This can be true or false, if this is set to true, images will work and it will try to directly use your Jellyfin URL to display the image (provided imgur_images and litterbox_images are both false, which they are by default). If your Jellyfin instance is not hosted on the public internet, the images will fail to display. If this is the case, you can use the options documented below.

Default

"enable_images": true

Imgur Images

Depends on enable_images being set to true and a client_id being set.

This can be true or false, if this is set to true it will use an Imgur URL for the image instead of your Jellyfin URL.

Imgur is a public image hosting service which allows you to host images without a server. In this case we can use it to display the cover image of your currently playing media without exposing your Jellyfin instance to the public internet.

Default

"imgur_images": false

Litterbox Images

Depends on enable_images being set to true.

This can be true or false, if this is set to true it will use a Litterbox URL for the image instead of your Jellyfin URL.

Litterbox is a public image hosting service which acts as temporary file storage. This allows us to display the cover image of your currently playing media without exposing your Jellyfin instance to the public internet. When litterbox_images is set to true, your cover images will stay up for 3 days, after which they are deleted. jellyfin-rpc automatically detects if an image has expired and re-uploads it if necessary.

Default

"litterbox_images": false

Process Images

Depends on enable_images and either imgur_images or litterbox_images being set to true.

This option will perform light image processing before uploading to your selected image host. The processing comes in the form of scaling the image to fit Discord's 1:1 aspect ratio for RPC images, as well as creating a blurred background for any area of the canvas that are otherwise empty. The following screenshot examples demonstrate the feature:

"process_images": false:

image

"process_images: true":

image

If no third-party image host is set, this process will not run, as Jellyfin is only intended to host its own images.

Default

"process_images": true

Clone this wiki locally