v2.0 - Full gallery redesign

This is a complete rebuild of the gallery to match Immich's native look and feel, with major improvements for large galleries, and adding individual image selection for downloading.

Highlights

• New gallery design - justified-rows layout on desktop, edge-to-edge square grid on mobile, light/dark mode following system preference, all styled to match Immich
• New lightbox - PhotoSwipe v5 replaces lightGallery, with proper pinch-zoom, swipe-to-dismiss, and a much smaller bundle
• Handles huge galleries - virtualised rendering keeps the DOM small even for shares of 5,000+ photos (#201). Only tiles within +/- 1 viewport-height of the current scroll position exist in the DOM at any moment. Layout for all items is pre-computed up front so the scrollbar stays accurate. (example large(ish) gallery)
• Multi-select with selective download - long-press or click a tile's checkmark to enter select mode, pick photos, download just those as a zip
• Date grouping - optional month-grouped gallery view, to match Immich's date grouping (off by default)
• Blur placeholders - uses Immich's thumbhash data for a blurred preview behind every tile while the thumbnail loads

Changed

• Replaced lightGallery with PhotoSwipe v5 - different lightbox engine, smaller bundle, gestures and zoom work natively on touch
• Templating engine switched from EJS to Preact + JSX
• Server-rendered HTML is much smaller (around 10x reduction) - only the data flows to the client; tiles are rendered by JS via virtualisation
• Serve font locally rather than via CDN for privacy / no-tracking

Breaking changes

By default, the gallery title will now be shown, to match Immich's behaviour. In IPP 1.x the title was hidden by default. To hide the title, change showTitle to false in your config.json

Configuration migration

Legacy configs continue to work. A backward-compatibility shim at startup detects the old keys and maps them onto the new schema, then logs a single deprecation notice. You'll see something like:

[IPP] Top-level gallery keys (singleImageGallery, singleItemAutoOpen, showGalleryTitle, showGalleryDescription, groupGalleryByDate) are deprecated; please move them under ipp.gallery.*. See README.

To migrate, restructure your config.json from this:

{
	"ipp": {
		"singleImageGallery": false,
		"singleItemAutoOpen": true,
		"showGalleryTitle": false,
		"showGalleryDescription": false,
		"groupGalleryByDate": false
	},
	"lightGallery": {
		"controls": true,
		"download": true,
		"mobileSettings": { "controls": false, "download": true }
	}
}

…to this:

{
	"ipp": {
		"gallery": {
			"singleImage": false,
			"singleItemAutoOpen": true,
			"showTitle": false,
			"showDescription": false,
			"groupByDate": false
		},
		"lightbox": {
			"showArrows": true,
			"showDownload": true,
			"mobileArrows": false
		}
	}
}

The compatibility shim will keep your old config working in the meantime. The shim may be removed in a future major release.

Acknowledgments

This release brings together work from several open-source projects, used under their respective licenses:

• PhotoSwipe (https://photoswipe.com/) v5 - MIT
• Inter (https://rsms.me/inter/) by Rasmus Andersson - OFL-1.1
• thumbhash (https://github.com/evanw/thumbhash) by Evan Wallace - MIT
• Material Design Icons (https://pictogrammers.com/library/mdi/) - Apache-2.0
• Preact (https://preactjs.com/) - MIT