tobimori/kirby-thumbhash

Kirby Image placeholders with the smarter ThumbHash integration

2.1.0 2026-02-27 19:13 UTC

Requires

• php: >=8.3.0
• ext-gd: *
• getkirby/composer-installer: ^1.2
• srwiez/thumbhash: ^1.1

Requires (Dev)

• getkirby/cms: ^5.0

Suggests

• ext-imagick: For better performance and quality with Imagick driver

MIT

• Tobias Möritz

README

Kirby ThumbHash

ThumbHash is an image placeholder algorithm. Placeholders are represented by small ∼28 bytes hashes such as 1QcSHQRnh493V4dIh4eXh1h4kJUI. A demo and more information can be found on the website.

This plugin adds ThumbHash support to Kirby, allowing you to implement UX improvements such as progressive image loading or content-aware spoiler images like Mastodon.

Under the hood, the heavy work gets done by a PHP implementation of ThumbHash by SRWieZ: SRWieZ/thumbhash

Get started

Read the documentation to get started with Kirby ThumbHash.

Credits

• Johann Schopplich's Kirby Blurry Placeholder plugin that set the baseline for this plugin (Licensed under MIT License - Copyright © 2020-2022 Johann Schopplich)

License

MIT License Copyright © 2023-2025 Tobias Möritz