David Degner

AVIF Local Support adds modern AVIF image support to WordPress while keeping compatibility with existing JPEG media. Built by a <a href="https://www.daviddegner.com" rel="nofollow ugc">Boston photographer</a> who needs it for their own portfolio website.
GitHub Repository: <a href="https://github.com/ddegner/avif-local-support" rel="nofollow ugc">https://github.com/ddegner/avif-local-support</a>
<ul>
<li>Local-first: all processing happens on your own server — no external calls. Works well for me on a shared CPU with 2GB of RAM on Linode.</li>
<li>Image quality first: uses Imagick PHP and CLI when available for high-quality resizing (LANCZOS), corrects EXIF orientation, and preserves ICC color profiles and EXIF/XMP/IPTC metadata when possible.</li>
<li>Tunable quality and speed: set AVIF quality (0–100) and encoder speed (0–10) to balance fidelity and performance. You can even adjust choose chroma subsampling (4:2:0, 4:2:2, 4:4:4) and bit depth (8/10/12-bit). Defaults: 4:2:0 and 8-bit if your server supports it and you want higher quality images.</li>
<li>Wraps existing <code><img></code> tags in <code><picture></code> with an AVIF <code><source></code> when an <code>.avif</code> version is present.</li>
<li>Converts JPEG originals and generated sizes to AVIF on upload, or via a daily/background scan.</li>
<li>Preserves EXIF/XMP/IPTC metadata and ICC color profiles by default (when using ImageMagick/Imagick).</li>
<li>WordPress-aware resizing logic enabled by default to avoid double-resizing when generating AVIF sizes from originals.
<ul>
<li>Tools include: convert missing AVIFs, upload a test JPEG, and delete all AVIF files in uploads.</li>
</ul>
</li>
</ul>
<h4>How it works</h4>
<ul>
<li>Front end: Filters common image outputs to add an AVIF <code><source></code> ahead of the original JPEG. Browsers that support AVIF will use it; others fall back to JPEG.</li>
<li>Conversion: Uses Imagick when available (preferred) — with auto-orientation and LANCZOS resizing — or GD with an AVIF encoder. Quality, speed, chroma subsampling, and bit depth are configurable (subsampling/bit depth applied via Imagick when supported).</li>
<li>Scheduling: Optional daily scan to backfill missing <code>.avif</code> files for existing JPEGs.</li>
</ul>
<h4>Requirements</h4>
<ul>
<li>PHP 8.0 or later (8.1+ recommended)</li>
<li>WordPress 6.5 or later</li>
<li>Imagick PHP extension recommended for best quality and metadata/ICC preservation. GD fallback supported.</li>
</ul>
<h3>Ubuntu/Debian setup (summary)</h3>
For local JPEG→AVIF conversion you need either Imagick with AVIF-enabled ImageMagick, or GD with AVIF support:
<ul>
<li>
Imagick path (recommended)
<ul>
<li>PHP extension: imagick</li>
<li>System libraries: ImageMagick built with HEIF/AVIF support (via libheif)</li>
<li>Notes: This path enables higher-quality resizing and preserves metadata/ICC profiles</li>
</ul>
</li>
<li>
GD path (fallback)
<ul>
<li>PHP extension: gd built with AVIF support (provides <code>imageavif</code> on PHP 8.1+)</li>
<li>Notes: Ensure your distro’s PHP GD is compiled with AVIF; some builds omit it</li>
</ul>
</li>
<li>
Helpful extras
<ul>
<li>PHP exif extension (for orientation handling in the GD fallback)</li>
<li>Web server configured to serve <code>.avif</code> as <code>image/avif</code> (Apache/Nginx/LiteSpeed)</li>
</ul>
</li>
</ul>
Official documentation: 
– PHP Imagick installation: https://www.php.net/imagick 
– PHP GD installation (AVIF details): https://www.php.net/manual/en/image.installation.php 
– ImageMagick format support (AVIF/HEIF): https://imagemagick.org/script/formats.php 
– Apache MIME configuration: https://httpd.apache.org/docs/current/mod/mod_mime.html 
– Nginx MIME configuration: https://nginx.org/en/docs/http/ngx_http_types_module.html

AVIF Local Support

AVIF support for converting and serving high quality photos. Built by a photographer, not trying to sell subscriptions.

Jordy Meow

Perfect Images handles the basics of WordPress image management that should have been built-in from the start. Manage image sizes, disable the ones you don’t need, add custom sizes, and regenerate thumbnails in bulk. It’s the essential foundation every WordPress install needs for clean, efficient image handling.
Think of it as your image management base layer. WordPress creates too many sizes? Disable them. Need a custom thumbnail size? Add it. Want retina support or modern formats like WebP/AVIF? Enable those modules. Perfect Images gives you complete control without bloat.
Explore <a href="https://meowapps.com/wp-retina-2x" rel="nofollow ugc">our official site</a> and check out <a href="https://meowapps.com/wp-retina-2x/tutorial/" rel="nofollow ugc">the tutorial</a> to get started.
<h3>Core Features</h3>
⚙️ Image Size Management 
The foundation of everything. View all registered image sizes (WordPress defaults, theme sizes, plugin sizes), disable the ones you don’t need, and add custom sizes. Finally, control over those pesky WordPress-generated sizes like <code>medium_large</code>, <code>1536x1536</code>, and <code>2048x2048</code>.
🔄 Regenerate Thumbnails 
Bulk regenerate thumbnails after changing sizes or switching themes. Progress tracking, smart processing, and automatic cleanup of old unused sizes.
🖼️ Retina Images (Module) 
Optional module for high-DPI displays. Automatically generate and serve crisp @2x versions of your thumbnails. Works seamlessly with WordPress responsive images.
🎨 Modern Formats (Module) 
Optional WebP/AVIF conversion. Convert images to modern formats for smaller file sizes and faster loading—without replacing your originals.
🤖 AI Upscaling (Module) 
Optional AI-powered upscaling via Claid.ai. Generate larger thumbnails than your source image, or create retina versions without needing 2x originals.
<h3>🖼️ Retina Images</h3>
Your visitors expect sharp, crisp images. Perfect Images makes retina support effortless.
Smart Generation:
<ul>
<li>Automatic retina creation for all thumbnail sizes</li>
<li>Multiple delivery methods (Responsive Images, PictureFill, Retina.js)</li>
<li>Works with WordPress srcset natively</li>
<li>Full-size retina support</li>
</ul>
Delivery Options:
<ul>
<li>Responsive Images: Modern, standard method</li>
<li>PictureFill: Hybrid approach with fallbacks</li>
<li>Retina.js: Client-side detection</li>
<li>Choose what fits your theme best</li>
</ul>
<h3>🎨 Modern Formats</h3>
WebP and AVIF offer dramatically better compression than JPEG/PNG—up to 50% smaller files with the same visual quality.
What You Get:
<ul>
<li>Generate WebP or AVIF for any image size</li>
<li>Automatic browser detection and fallbacks</li>
<li>Works alongside your original images</li>
<li>Enable for thumbnails or full-size</li>
<li>Responsive Images delivery built-in</li>
</ul>
<h3>🤖 AI Features</h3>
Perfect Images integrates with AI services like Claid.ai to unlock powerful upscaling.
Upscaling:
<ul>
<li>Generate retina images without 2x source files</li>
<li>Create thumbnails larger than the original image</li>
<li>Multiple upscaling modes (Smart Enhance, Digital Art, Photo, etc.)</li>
<li>Automatic or manual processing</li>
</ul>
<h3>⚙️ Image Management</h3>
Regenerate Thumbnails:
<ul>
<li>Bulk regenerate all thumbnails</li>
<li>Progress tracking for large libraries</li>
<li>Preserves custom crops</li>
<li>Updates retina and WebP versions automatically</li>
</ul>
Replace Images:
<ul>
<li>Swap images directly from Media Library</li>
<li>Drag & drop replacement in dashboard</li>
<li>Maintains all metadata and links</li>
<li>Updates all thumbnails instantly</li>
</ul>
Manage Sizes:
<ul>
<li>View all registered image sizes</li>
<li>Disable unwanted sizes (medium_large, 1536×1536, etc.)</li>
<li>Create custom sizes</li>
<li>Track which sizes are enabled per image</li>
</ul>
Disable Image Threshold:
<ul>
<li>Stop WordPress from creating “-scaled” versions</li>
<li>Keep your original full-size images intact</li>
</ul>
<h3>Pro Features</h3>
<ul>
<li>Full-size retina images</li>
<li>Full-size WebP/AVIF conversion</li>
<li>Priority support</li>
</ul>
<h3>Why Perfect Images?</h3>
Essential Foundation 
Every WordPress site needs proper image size management and thumbnail control. Perfect Images makes it simple, giving you the baseline image handling WordPress should have included.
Modular & Lightweight 
Start with just image size management and thumbnail regeneration. Enable retina, WebP, or AI modules only if you need them. No bloat, no unnecessary features.
Works with Everything 
Compatible with WooCommerce, page builders, galleries, and any theme. It uses WordPress’s native image handling, so there are no conflicts.
No Database Bloat 
Everything works through WordPress’s existing metadata structure. No custom tables, no performance overhead.
Built for Real Workflows 
Developed by someone who manages dozens of WordPress sites. Every feature solves a real problem we’ve encountered over years of WordPress development.

Perfect Images

The foundational image management plugin for WordPress. Control image sizes, regenerate thumbnails, enable retina, add modern formats—everything you n …

AVIF Local Support vs Perfect Images