PHPackages blue-tomato/image-blurhash - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Image & Media](/categories/media) 4. / 5. blue-tomato/image-blurhash ActiveProcesswire-module[Image & Media](/categories/media) blue-tomato/image-blurhash ========================== Module for ProcessWire which automatically generates Blurhashs. 3.1.0(11mo ago)42.1k↓50%2MITPHPPHP >=8.3 Since Jun 9Pushed 11mo ago4 watchersCompare [ Source](https://github.com/blue-tomato/ImageBlurhash)[ Packagist](https://packagist.org/packages/blue-tomato/image-blurhash)[ Docs](https://github.com/blue-tomato/ImageBlurhash)[ RSS](/packages/blue-tomato-image-blurhash/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (2)Versions (15)Used By (0) ImageBlurhash ============= [](#imageblurhash) ImageBlurhash is a module for ProcessWire CMS which automatically generates Blurhash strings for uploaded images. What is Blurhash? ----------------- [](#what-is-blurhash) > BlurHash is a compact representation of a placeholder for an image. E.g. used for lazy loading placeholders. More about Blurhash itself: - - Usage ----- [](#usage) ### Installation [](#installation) 1. Execute the following command in the root directory of your ProcessWire installation: ``` composer require blue-tomato/image-blurhash ``` 2. ProcessWire will detect the module and list it in the backend's `Modules` > `Site` > `ImageBlurhash` section. Navigate there and install it. ### Configuration [](#configuration) Activate Blurhash in the field setting of the image: `Setup` > `Fields` > `image_field` > `Details` > `Generate Blurhash Strings` ### API [](#api) ``` $page->image_field->blurhash ``` Return's the encoded Blurhash as string or false if not existing --- ``` $page->image_field->getBlurhashDataUri(float $width, float $height) ``` E.g. ``` ``` Returns the decoded Blurhash as base64 PNG datauri for usage in an image. If not existing transparent GIF image will be returned. Hint: If your image is 500x300 pixels, you can use 50x30 for the Blurhash Data-URI and and scale up the image with CSS. This makes Blurhash decoding faster, the data-uri smaller but the quality is still good. ### Migration of existing images [](#migration-of-existing-images) For migration of existing fields there are two CLI script in the module directory #### regenerateImages.php [](#regenerateimagesphp) E.g. ``` php regenerateImages.php ``` Generates for all image fields who have the createBlurhash option new Blurhashs. #### generateEmptyImages.php [](#generateemptyimagesphp) E.g. ``` php generateEmptyImages.php ``` Generates for all image fields who have the createBlurhash option and have no Blurhash in the database a new Blurhash. Roadmap ------- [](#roadmap) Currently encoding component quality default to 4x3. In the future this value will be configurable over the field settings for each field. Support ------- [](#support) Please [open an issue](https://github.com/blue-tomato/ImageBlurhash/issues/new) for support. Contributing ------------ [](#contributing) Create a branch on your fork, add commits to your fork, and open a pull request from your fork to this repository. To get better insights and onboard you on module implementation details just open a support issue. We'll get back to you asap. License ------- [](#license) Find all information about this module's license in the LICENCE.txt file. ### Health Score 46 — FairBetter than 93% of packages Maintenance50 Moderate activity, may be stable Popularity26 Limited adoption so far Community12 Small or concentrated contributor base Maturity78 Established project with proven stability Bus Factor1 Top contributor holds 96.9% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~139 days Recently: every ~357 days Total 14 Last Release 357d ago Major Versions 1.0.1 → 2.0.02020-06-16 2.0.7 → 3.0.02025-05-20 PHP version history (2 changes)1.0.0PHP >=7.0 3.0.0PHP >=8.3 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/41725719?v=4)[Blue Tomato](/maintainers/blue-tomato)[@blue-tomato](https://github.com/blue-tomato) --- Top Contributors [![tiefenb](https://avatars.githubusercontent.com/u/488163?v=4)](https://github.com/tiefenb "tiefenb (31 commits)")[![yuters](https://avatars.githubusercontent.com/u/801718?v=4)](https://github.com/yuters "yuters (1 commits)") --- Tags processwireplaceholderlazyloadblurhash ### Embed Badge ![Health badge](/badges/blue-tomato-image-blurhash/health.svg) ``` [![Health](https://phpackages.com/badges/blue-tomato-image-blurhash/health.svg)](https://phpackages.com/packages/blue-tomato-image-blurhash) ``` ### Alternatives [sitegeist/sms-responsive-images Provides ViewHelpers and configuration to render valid responsive images based on TYPO3's image cropping tool. 34493.1k2](/packages/sitegeist-sms-responsive-images)[daun/statamic-placeholders Generate low-quality image placeholders for lazyloading Statamic assets 106.6k](/packages/daun-statamic-placeholders)[sadovojav/yii2-image-thumbnail Yii2 image thumbnail component 2142.1k](/packages/sadovojav-yii2-image-thumbnail)[dodecastudio/craft-blurhash Render a BlurHash from a given image. 1214.9k2](/packages/dodecastudio-craft-blurhash)[dnadesign/silverstripe-lazyloaded-image Implements the LQIP (Low Quality Image Placeholder) pattern powered by lazysizes 1011.4k4](/packages/dnadesign-silverstripe-lazyloaded-image) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)