MD MEHEDI HASAN PARVEZ

Media Trim is the ultimate solution for keeping your WordPress media library clean and optimized. Stop wasting server space on unused images and forgotten uploads.
Whether you’re managing a small blog or a large content site, Media Trim scans your entire media library, identifies files that aren’t being used anywhere, and gives you the power to safely remove them with a single click.
<h3>Why Choose Media Trim?</h3>
<ul>
<li>Smart Detection: Advanced scanning algorithms detect truly unused media by checking posts, pages, custom post types, meta fields, widgets, and theme options.</li>
<li>Safe Cleanup: Files are moved to a trash system first, allowing you to restore them if needed before permanent deletion.</li>
<li>Duplicate Finder: Identify and merge duplicate files to save even more space.</li>
<li>File System Scanner: Find orphaned files on disk that aren’t in the media library.</li>
</ul>
<h3>Key Features</h3>
<ul>
<li>Unused Media Detection: Scan and identify media files not used anywhere on your site.</li>
<li>Duplicate Media Finder: Find files with identical content and merge them.</li>
<li>File System Scanner: Discover orphaned files in your uploads folder.</li>
<li>Trash System: Safe deletion with restore capability before permanent removal.</li>
<li>Bulk Actions: Delete, trash, or restore multiple files at once.</li>
<li>Detailed Reports: See exactly where each media file is being used.</li>
<li>Performance Optimized: Batch processing to handle large media libraries.</li>
</ul>
<h3>External Services</h3>
This plugin connects to external third-party services to provide specific features. Below is a detailed disclosure of each service used:
<h4>Pexels API</h4>
This plugin includes an optional “Stock Images” feature that integrates with the Pexels API to search and import free stock photos directly into your site.
<ul>
<li>What it does: Provides a searchable library of free-to-use stock images within the “Stock Images” tab.</li>
<li>When data is sent: Only when you actively search for images or import a specific photo. No data is sent automatically or in the background.</li>
<li>What data is sent: Your search terms and pagination preferences are sent to Pexels. Your Pexels API key (if provided in Settings) is sent as an authorization header.</li>
<li>Service Provider: Pexels (Canva Pty Ltd)</li>
<li>Terms of Use: <a href="https://www.pexels.com/terms-of-service/" rel="nofollow ugc">https://www.pexels.com/terms-of-service/</a></li>
<li>Privacy Policy: <a href="https://www.pexels.com/privacy-policy/" rel="nofollow ugc">https://www.pexels.com/privacy-policy/</a></li>
</ul>
<h3>Development</h3>
This plugin uses <code>@wordpress/scripts</code> for building the admin dashboard React application. The human-readable source code is located in the <code>admin/dashboard/</code> directory. To build the assets:
<ol>
<li>Run <code>npm install</code> to install dependencies.</li>
<li>Run <code>npm run build</code> to compile the production assets into <code>assets/admin/</code>.</li>
</ol>

Media Trim — Unused & Duplicate Media Cleaner

Clean up your WordPress media library by finding and removing unused, duplicate, and orphaned media files. Reclaim disk space instantly.

Hoatzinlabs

HoatzinMedia is a WordPress media cleaner and storage optimizer that helps you reclaim disk space and improve site performance by identifying unused attachments, oversized uploads, and storage pressure signals. It includes a clear dashboard, a reversible trash workflow, and batch-based scanning designed for large media libraries.
Benefits:
<ol>
<li>Reduce storage usage by finding unused and heavy media files</li>
<li>Improve WordPress performance by keeping uploads lean and organized</li>
<li>Delete with confidence using a safe trash table with restore support</li>
<li>Scale to large sites with batch processing and scan locking</li>
</ol>
<h3>Modules</h3>
<ol>
<li>
Dashboard
<ul>
<li>What it does: Shows media health score, server/storage signals, and library breakdowns.</li>
<li>REST endpoints: GET /wp-json/hoatzinmedia/v1/dashboard, GET /wp-json/hoatzinmedia/v1/dashboard/uploads-breakdown</li>
<li>Hook points: Refreshes automatically after content changes via save_post cache bump; scan completion clears the dashboard transient.</li>
</ul>
</li>
<li>
Smart Scan & Unused Media
<ul>
<li>What it does: Batch-based scanning to detect unused attachments, then review and delete safely.</li>
<li>REST endpoints: POST /wp-json/hoatzinmedia/v1/scan, GET /wp-json/hoatzinmedia/v1/unused-results, POST /wp-json/hoatzinmedia/v1/delete-unused, POST /wp-json/hoatzinmedia/v1/delete-unused-all</li>
<li>Hook points: WP-Cron action hoatzinmedia_scheduled_scan runs a full scan when scheduling is enabled; the scanner uses posts_where during content search to reduce query overhead.</li>
</ul>
</li>
<li>
Large Files Explorer
<ul>
<li>What it does: Lists media files over a size threshold so you can quickly reclaim space.</li>
<li>REST endpoints: GET /wp-json/hoatzinmedia/v1/large-files?size=1|3|5 (MB threshold)</li>
</ul>
</li>
<li>
Duplicate Checker
<ul>
<li>What it does: Finds likely duplicate attachments and helps you validate before removal.</li>
<li>REST endpoints: GET /wp-json/hoatzinmedia/v1/duplicates, GET /wp-json/hoatzinmedia/v1/attachment-usage?attachment_id=123</li>
<li>Hook points: Adds Media Library UI enhancements via manage_upload_columns, manage_media_columns, and manage_media_custom_column.</li>
</ul>
</li>
<li>
Convert to WebP / AVIF
<ul>
<li>What it does: Converts images to modern formats (WebP/AVIF) and manages converted variants.</li>
<li>REST endpoints:
<ul>
<li>Settings: GET/POST /wp-json/hoatzinmedia/v1/converter-settings, GET /wp-json/hoatzinmedia/v1/converter-settings/scan</li>
<li>Converter: /wp-json/hoatzinmedia/v1/image-formats/library, /image-formats/convert, /image-formats/background, /image-formats/background/status, /image-formats/background/log, /image-formats/background/cancel, /image-formats/background/pause, /image-formats/background/resume, /image-formats/delete</li>
</ul>
</li>
<li>Hook points: add_attachment can auto-convert new JPEG/PNG uploads based on settings; delete_attachment cleans up converted variants; background jobs run on the hoatzinmedia_convert_job_run action.</li>
</ul>
</li>
<li>
Regenerate Thumbnails
<ul>
<li>What it does: Rebuilds WordPress image sizes for selected attachments (useful after theme changes).</li>
<li>REST endpoints: GET /wp-json/hoatzinmedia/v1/regenerate/library, GET /wp-json/hoatzinmedia/v1/regenerate/sizes, POST /wp-json/hoatzinmedia/v1/regenerate, plus background endpoints under /regenerate/background/*</li>
<li>Hook points: Background jobs run on the hoatzinmedia_regenerate_job_run action.</li>
</ul>
</li>
<li>
Modules & Settings
<ul>
<li>What it does: Enables/disables features and stores global plugin settings.</li>
<li>REST endpoints: GET/POST /wp-json/hoatzinmedia/v1/modules, GET/POST /wp-json/hoatzinmedia/v1/settings, GET /wp-json/hoatzinmedia/v1/status</li>
<li>Hook points: admin_menu registers the HoatzinMedia admin pages; init ensures scan scheduling and updates WebP serving rules when enabled.</li>
</ul>
</li>
<li>
SVG Upload Support (optional)
<ul>
<li>What it does: Allows SVG uploads with sanitization safeguards (including Elementor compatibility).</li>
<li>Hook points: upload_mimes, wp_check_filetype_and_ext, wp_handle_upload_prefilter, wp_handle_sideload_prefilter, elementor/files/allow_unfiltered_upload, elementor/files/allow-file-type/svg</li>
</ul>
</li>
</ol>
Core features:
<ol>
<li>Dashboard with media health score and live metrics</li>
<li>Unused media scanner with batch processing and locking</li>
<li>Safe trash table for reversible deletions</li>
<li>Large file explorer by size threshold</li>
<li>Translation-ready UI and REST responses</li>
</ol>
<h3>Usage</h3>
<ol>
<li>Review the media health score and high-level stats on the dashboard.</li>
<li>Run an unused media scan from the Unused media scanner panel.</li>
<li>Inspect results and move files to the HoatzinMedia trash.</li>
<li>Use the large file explorer to identify heavy attachments by size.</li>
</ol>

HoatzinMedia — Media Cleaner & Storage Optimizer

Smart media cleaner: detect unused files, duplicates and large attachments; optimize storage safely.

Media Trim — Unused & Duplicate Media Cleaner vs HoatzinMedia — Media Cleaner & Storage Optimizer