Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/headwalluk/tidy-resize-images/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
A WordPress plugin for keeping the Media Library lean. It resizes oversized uploads, converts unsuitable file formats, and recompresses bloated files — with originals safely backed up and a dry-run preview.
Who it's for
- Site operators who want their Media Library to stop growing without bound, without giving up the ability to undo a change.
- Developers who want a small, hookable plugin they can extend (custom format-decision logic, bulk-processing integrations, etc.) instead of fighting a large SaaS-coupled image optimizer.
Documentation
- docs/README.md — index and quick links
- docs/use-cases/new-site.md — install on a clean WordPress
- docs/use-cases/inherited-site.md — bulk-update workflow for sites full of historical oversized images
- docs/wp-cli.md — full WP-CLI command reference
- docs/hooks-and-filters.md — extension points (
tri_format_decisionand others)
License
GPLv2 or later. See LICENSE for the full text.
Author
Paul Faulkner — headwall-hosting.com