WP Manifestindependent plugin directory
manifest / media / compress-my-ass

Compress My A$$

Compress My A$$ - Zero-Bloat, Zero-SaaS Local Image Compression & Next-Gen Format Hyper-Optimizer for WordPress

★ 0stars

Install

Download source zip No release zip yet

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/cynthiaschomp/compress-my-ass/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Compress My A$$ (CMA) 🗜️🖼️

Zero-Bloat, Zero-SaaS Local Image Compression & Next-Gen Format Hyper-Optimizer for WordPress
The 5th Pillar of the Whole A$$ Security Suite by securemyass.com.
Direct open-architecture, privacy-first alternative to ShortPixel, Imagify, and Smush.


⚡ Key Highlights

  • 100% On-Server Execution: Zero external cloud queues, zero recurring monthly API subscription fees, zero privacy leaks, and zero monthly image quota throttles.
  • Multi-Driver Local Engine: Automatic environmental driver detection prioritizing PHP Imagick, PHP GD, and CLI binaries (cwebp, avifenc).
  • Next-Gen WebP & AVIF Generation: Automatically compiles companion .webp and .avif assets for master images and all registered WordPress sub-sizes (thumbnails, medium, large).
  • Non-Destructive Master Media Vault: Safely archives untouched master images into /wp-content/uploads/cma-vault/ fortified by Triple Execution Barriers (.htaccess, .user.ini, index.php) with 1-click rollback.
  • Dynamic <picture> Tag Delivery: Injects modern <picture><source type="image/webp" ...><img ...></picture> on frontend page render for 100% browser compatibility and instant LCP optimization.
  • Chunked Bulk Recompressor: Asynchronous batch processor with real-time AJAX streaming, pause/resume capability, and zero PHP execution timeout risk.
  • Media Library Integration: Adds granular compression metrics, WebP indicators, and inline optimize/restore actions directly to WordPress upload.php list view.
  • Full WP-CLI Suite: Headless server control via wp cma status, wp cma compress, wp cma restore, wp cma generate-webp, and wp cma benchmark.
  • Whole A$$ Suite Synergy: Natively recognized by Speed My A$$ Up (SMAU); CMA WebP images are prioritized by SMAU's SMAU_Media_Engine as high-priority LCP targets.

🥊 Head-to-Head: Compress My A$$ vs. Cloud SaaS Plugins

Capability ShortPixel / Imagify / Smush Compress My A$$ (CMA)
Architecture Third-party cloud SaaS queue 100% On-Server (Zero SaaS)
Monthly Image Quotas Strict credit limits (e.g., 5,000 credits/mo) Unlimited (Zero Quotas)
Data Privacy & OPSEC Transmits assets to external third-party servers Air-gapped on your host
Downtime Vulnerability Fails if vendor API is down or throttled Immune to external outages
Master Vaulting Proprietary cloud or raw disk storage Triple-Barrier Isolated Vault
Core Web Vitals Synergy Standalone tool Native Synergy with SMAU & GMA
WP-CLI Automation Basic or none Full wp cma command suite

💻 WP-CLI Command Reference

Command Purpose
wp cma status View active image driver, library optimization stats, vault storage, and suite interop.
wp cma compress --all Bulk compress all uncompressed media assets with a terminal progress bar.
wp cma compress --id=<id> Compress a specific media attachment and all its registered sub-sizes.
wp cma compress --all --force Force re-compression of all media assets across the library.
wp cma restore --id=<id> Restore an attachment from the non-destructive master vault.
wp cma restore --all Restore all vaulted media back to pristine master uncompressed state.
wp cma benchmark Run a live synthetic compression benchmark comparing JPEG, WebP, and AVIF size & speed.

🏗️ Architecture & Pipeline

                     Incoming Media Upload (or Bulk Scan)
                                      │
                                      ▼
             ┌─────────────────────────────────────────────────┐
             │       CMA Non-Destructive Vault Backup          │
             │   Stores original master into /cma-vault/       │
             │   Enforces Triple Barrier (.htaccess/.user.ini) │
             └────────────────────────┬────────────────────────┘
                                      │
                                      ▼
             ┌─────────────────────────────────────────────────┐
             │         Multi-Driver Compression Engine         │
             │   • Driver Priority: Imagick > GD > CLI         │
             │   • Auto-Downscale (e.g. >2560px)               │
             │   • EXIF / Metadata Stripping                   │
             │   • Quality Optimization (Lossless/Balanced)    │
             └────────────────────────┬────────────────────────┘
                                      │
                                      ▼
             ┌─────────────────────────────────────────────────┐
             │          Next-Gen WebP & AVIF Compiler          │
             │   Generates companion .webp for master & sizes  │
             └────────────────────────┬────────────────────────┘
                                      │
                                      ▼
             ┌─────────────────────────────────────────────────┐
             │            Frontend <picture> Rewriter          │
             │   Transparently serves WebP to modern browsers  │
             │   Coordinates with Speed My A$$ Up (LCP Turbo)  │
             └─────────────────────────────────────────────────┘

🔒 Whole A$$ Security Suite Interoperability

Compress My A$$ coordinates natively with companion products in the Whole A$$ Security Suite:

  • Speed My A$$ Up: CMA WebP and AVIF assets are recognized and prioritized by SMAU as high-priority LCP targets.
  • Guard My A$$: Pre-boot entropy filtering protects media uploads and REST endpoints from exploit payloads.
  • Back My A$$ Up: Securely vaults untouched master images in /cma-vault/ before cloud replication.
  • Secure My A$$: Enforces execution barriers (.htaccess, .user.ini, index.php) inside media vault directories.
  • Doc My A$$: High-velocity developer documentation system, Cmd+K search, Docs-as-Code, and zero-bloat standalone reader.

📄 License & Attribution

Developed by Cynthia Schomp as part of the Whole A$$ Security Suite for securemyass.com.
Licensed under the GNU General Public License v3.0.