OctoTidy

by GM8 · github.com/mrichwalsky/octotidy

★ 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/mrichwalsky/octotidy/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.

Readme github.com/mrichwalsky/octotidy ↗

OctoTidy is a small WordPress plugin MVP for finding Media Library assets that are likely unused.

Tagline: Media Attachment Verifier.

It adds Media > OctoTidy Verifier in WP Admin. Click Run Verification to check common WordPress storage locations for attachment URLs, generated image-size URLs, and common attachment ID references.

What It Checks

Post and page content
Post excerpts
Post meta, including builder JSON/serialized data
Term meta
Comment meta
Options, excluding transients
Original attachment URLs and generated image-size files
Common ID references such as wp-image-123, gallery IDs, attachment_id, image_id, thumbnail_id, and serialized equivalents

Bulk Cleanup

After a verification run, OctoTidy can move the current Likely unused results to the Media Library Trash. The cleanup form requires a checkbox, typing DELETE, and a browser confirmation.

MVP Limits

The report says Likely unused, not definitely unused. This first version does not crawl rendered frontend pages or parse theme/plugin source files.

Use it as a review tool before removing media.