Supported Formats

Wallpaper Server indexes and accepts a fixed set of image formats, controlled by the supported_extensions configuration field.

Default formats

Extension	Content type
.jpg	image/jpeg
.jpeg	image/jpeg
.png	image/png
.webp	image/webp

Files with any other extension are:

• Skipped silently during folder scans.
• Rejected with 400 when uploaded (unsupported file extension).

Changing the list

Set supported_extensions in your configuration file to override the defaults. Include the leading dot on each entry:

supported_extensions:
  - .jpg
  - .jpeg
  - .png
  - .webp

Note

The server can only decode formats its image libraries understand. Adding an extension the underlying decoder cannot read will cause those files to fail analysis rather than appear in the gallery. The defaults are the tested set.

Thumbnails

Regardless of the source format, generated thumbnails are always encoded as JPEG. See Caching and storage.