Thumbs: Drop `disintegration/imaging` library integration #2446

New issue

Open

opened 2026-02-20 01:11:34 -05:00 by deekerman · 0 comments

deekerman commented

2026-02-20 01:11:34 -05:00

Owner

Originally created by @lastzero on GitHub (Nov 29, 2025).

Originally assigned to: @lastzero on GitHub.

In order for us to add native support for modern formats like HEIC/HEIF and AVIF, the imaging image library integration should be dropped — especially since it appears to be no longer maintained:

Environment	CLI Flag	Default	Description
PHOTOPRISM_THUMB_LIBRARY	--thumb-library	auto	image processing `LIBRARY` to be used for generating thumbnails (auto, imaging, vips)
PHOTOPRISM_THUMB_COLOR	--thumb-color	auto	standard color `PROFILE` for thumbnails (auto, preserve, srgb, none)
PHOTOPRISM_THUMB_FILTER	--thumb-filter	auto	downscaling filter `NAME` (imaging best to worst: blackman, lanczos, cubic, linear, nearest)
PHOTOPRISM_THUMB_SIZE	--thumb-size	1920	maximum size of pre-generated thumbnails in `PIXELS` (720-7680)
PHOTOPRISM_THUMB_SIZE_UNCACHED	--thumb-size-uncached	5120	maximum size of thumbnails generated on demand in `PIXELS` (720-7680)
PHOTOPRISM_THUMB_UNCACHED	--thumb-uncached		generates missing thumbnails on demand (high memory and cpu usage)

Originally created by @lastzero on GitHub (Nov 29, 2025). Originally assigned to: @lastzero on GitHub. In order for us to add native [support for modern formats](https://github.com/photoprism/photoprism/issues/668) like HEIC/HEIF and AVIF, [the **imaging** image library](https://github.com/disintegration/imaging) integration should be dropped — especially since it appears to be no longer maintained: | Environment | CLI Flag | Default | Description | |:-------------------------------|:----------------------|:--------|:---------------------------------------------------------------------------------------------| | PHOTOPRISM_THUMB_LIBRARY | --thumb-library | auto | image processing `LIBRARY` to be used for generating thumbnails (auto, **imaging**, vips) | | PHOTOPRISM_THUMB_COLOR | --thumb-color | auto | standard color `PROFILE` for thumbnails (auto, preserve, srgb, none) | | PHOTOPRISM_THUMB_FILTER | --thumb-filter | auto | downscaling filter `NAME` (**imaging** best to worst: blackman, lanczos, cubic, linear, nearest) | | PHOTOPRISM_THUMB_SIZE | --thumb-size | 1920 | maximum size of pre-generated thumbnails in `PIXELS` (720-7680) | | PHOTOPRISM_THUMB_SIZE_UNCACHED | --thumb-size-uncached | 5120 | maximum size of thumbnails generated on demand in `PIXELS` (720-7680) | | PHOTOPRISM_THUMB_UNCACHED | --thumb-uncached | | generates missing thumbnails on demand (high memory and cpu usage) | #### Related Issues: - https://github.com/photoprism/photoprism/issues/668 - https://github.com/photoprism/photoprism/issues/3342 - https://github.com/photoprism/photoprism/issues/3840 - https://github.com/photoprism/photoprism/issues/5066