Title: Snopix Author: Shalin Shah Published: May 29, 2026 Last modified: May 29, 2026 --- Search plugins ![](https://ps.w.org/snopix/assets/banner-772x250.png?rev=3554220) ![](https://ps.w.org/snopix/assets/icon-256x256.png?rev=3554194) # Snopix By [Shalin Shah](https://profiles.wordpress.org/sh4lin/) [Download](https://downloads.wordpress.org/plugin/snopix.0.1.1.zip) * [Details](https://mri.wordpress.org/plugins/snopix/#description) * [Reviews](https://mri.wordpress.org/plugins/snopix/#reviews) * [Installation](https://mri.wordpress.org/plugins/snopix/#installation) * [Development](https://mri.wordpress.org/plugins/snopix/#developers) [Support](https://wordpress.org/support/plugin/snopix/) ## Description Snopix adds reverse-image search to the WordPress media library. Upload an image( or drop one onto the dashboard widget) and the plugin returns the visually most similar attachments you already have indexed, ranked by a composite score over three fingerprints: * A 64-bit perceptual hash (pHash) over a DCT of the greyscale thumbnail * A 48-element RGB colour histogram * A 32-element Sobel edge-orientation histogram The same fingerprints power the **Duplicates** tab, which clusters near-identical attachments so you can keep one and bulk-delete the rest. #### Features * Reverse-image search via the admin dashboard or a `[snopix_search]` shortcode for the front end. * Block-editor panel on the core Shortcode block for inserting and editing the [ snopix_search] widget (variant, title, result cap). * Duplicate detection with per-group “keep” selection and bulk delete. * Background bulk indexing via WP-Cron — no PHP timeouts on large libraries. * REST API at `/wp-json/snopix/v1/` with rate limiting on the public search endpoint. * Settings panel: search visibility, rate limit, match and duplicate thresholds, indexer batch size, and probe downscale ceiling. * Setting to keep or drop the index when the plugin is uninstalled. * Tools panel: reindex everything, clear the index, delete orphan rows, flush caches. * Pre-downscale of large probe images before fingerprinting to keep search latency bounded. #### Supported MIME types ``` image/jpeg, `image/png`, `image/gif`, `image/webp`, `image/bmp`. ``` #### Where data lives Snopix creates a single custom table, `{prefix}snopix_index`, that stores one row per indexed attachment with its three fingerprints. Uninstalling the plugin drops the table unless you disable **Drop data on uninstall** in settings. ### Accuracy notice Snopix is functional, but search ranking, duplicate detection and the threshold tuning may be less accurate than expected – you may see occasional false positives or miss visually-similar images depending on your media library. Please report anything that looks off. ## Installation 1. Upload the `snopix` folder to `/wp-content/plugins/` (or install the zip via ** Plugins Add New Upload Plugin**). 2. Activate the plugin in **Plugins**. 3. Go to **Media Snopix** and click **Index Remaining** to fingerprint any attachments already in your library. This runs in the background via WP-Cron. 4. Once at least a handful of images are indexed, drop an image onto the **Search by Image** panel to test reverse-image search. #### Front-end shortcode Add the search widget to any post or page with: ``` [snopix_search] ``` Optional attributes: `variant` (`card`, `inline`, or `narrow`; default card), ` title` (header label; default “Search by image”), and `max_results` (1-48; default 12). For example: ``` [snopix_search variant="inline" max_results="24"] ``` The block editor also exposes these options via a **Snopix Search** panel on the core **Shortcode** block. By default the endpoint is open to anyone. Restrict it to logged-in users from the **Settings** tab in **Media Snopix**. ## FAQ ### What image formats are supported? JPEG, PNG, GIF, WebP, and BMP. Other types (SVG, HEIC, AVIF) are rejected at upload time by the indexer and again at the search endpoint. ### How big can my media library be? The fingerprint table stores one compact row per attachment, so the storage cost is small. Indexing scales linearly with the number of attachments. The bulk indexer runs in chained WP-Cron batches so it does not time out, but indexing a very large library (10k+) will take many minutes. ### Does it work with images stored on S3 / a CDN? The indexer needs to read raw bytes via PHP-GD. If your offload plugin keeps a local copy until indexing is complete, you are fine. If files are removed from the local filesystem before the indexer runs, those attachments will be skipped. ### How accurate is the search? The composite score combines pHash + colour + edge histograms with weights 0.40/ 0.35 / 0.25. In our internal test matrix, format conversions, resizing, and JPEG re-compression are recovered with > 0.95 similarity. Heavy Gaussian blur, extreme downscale (sub-128 px), and noise-corrupted images sit closer to the 0.85 threshold and may not always rank first. Tuning is ongoing. ### How is duplicate detection different from search? Both rely on the same fingerprints. Search returns ranked matches for an arbitrary probe image; duplicate detection clusters indexed images among themselves and surfaces every group with two or more visually-identical members. ### How do I uninstall cleanly? Deactivate, then delete the plugin from the **Plugins** screen. When the **Drop data on uninstall** setting is enabled (the default), the uninstall hook drops `{ prefix}snopix_index` and removes all plugin options and transients; disable it first if you want the index to survive a reinstall. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Snopix” is open source software. The following people have contributed to this plugin. Contributors * [ Shalin Shah ](https://profiles.wordpress.org/sh4lin/) * [ Amaan Khan ](https://profiles.wordpress.org/akrocks/) * [ Vishal Kakadiya ](https://profiles.wordpress.org/vishalkakadiya/) [Translate “Snopix” into your language.](https://translate.wordpress.org/projects/wp-plugins/snopix) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/snopix/), check out the [SVN repository](https://plugins.svn.wordpress.org/snopix/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/snopix/) by [RSS](https://plugins.trac.wordpress.org/log/snopix/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 0.1.1 * Fixed: certain extreme aspect-ratio images could trigger a fatal error during indexing; working dimensions are now clamped. * Changed: index vector columns now use LONGTEXT instead of JSON for compatibility with older MySQL / MariaDB. * Fixed: capitalised indexed-image status labels and corrected spacing on the duplicate“ Keep” badge. * Removed: the non-functional Plugins-screen delete-confirmation modal and its “ require confirmation” setting. The keep / drop-on-uninstall setting is unchanged. #### 0.1.0 * Initial release. * Perceptual hash + colour histogram + edge histogram fingerprinting. * Reverse-image search via admin dropzone and `[snopix_search]` shortcode. * Block-editor panel for inserting and configuring the search shortcode. * Duplicate detection with per-group keep selection. * WP-Cron bulk indexing, rate-limited public search endpoint. * Configurable thresholds, rate limit, and batch size, plus a keep or drop-on- uninstall choice. * WordPress.org compatibility: JPEG, PNG, GIF, WebP, BMP. ## Meta * Version **0.1.1** * Last updated **10 hours ago** * Active installations **Fewer than 10** * WordPress version ** 6.0 or higher ** * Tested up to **7.0** * PHP version ** 8.0 or higher ** * Language * [English (US)](https://wordpress.org/plugins/snopix/) * Tags * [duplicates](https://mri.wordpress.org/plugins/tags/duplicates/)[image search](https://mri.wordpress.org/plugins/tags/image-search/) [media library](https://mri.wordpress.org/plugins/tags/media-library/) * [Advanced View](https://mri.wordpress.org/plugins/snopix/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/snopix/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/snopix/reviews/) ## Contributors * [ Shalin Shah ](https://profiles.wordpress.org/sh4lin/) * [ Amaan Khan ](https://profiles.wordpress.org/akrocks/) * [ Vishal Kakadiya ](https://profiles.wordpress.org/vishalkakadiya/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/snopix/)