Skip to main content

Image Types

Decoding images

Komga doesn't always need to decode images within your books. Image decoding is necessary in the following cases:

  • thumbnail generation
  • ISBN barcode detection
  • analyze page dimensions
  • on-the-fly page conversion

If the client requesting a page can decode the format, Komga passes the raw image data without decoding.

Common types

The following types are supported on every platform:

  • JPEG
  • PNG
  • GIF
  • WebP

Advanced types

More advanced types are supported on some platforms only, as they rely on native libraries for decoding.

For WebP, the native library will be used if present. Else, the Java implementation will be used as fallback.

PlatformJPEG XL (jxl)AVIF / HEIFWebP
macOS app✔️✔️✔️ (native)
Windows app✔️✔️✔️ (java)
Docker amd64✔️✔️✔️ (native)
Docker arm64✔️✔️ (native)
Docker arm✔️ (java)

When using the jar, you will need to provide the native libraries yourself, and run Java with the correct arguments. You can check for more details here.