Title: TSO Image Master
Author: deadko
Published: 4 сар 17, 2026
Last modified: 5 сар 5, 2026
---
Search plugins
# TSO Image Master
By [deadko](https://profiles.wordpress.org/deadko/)
[Download](https://downloads.wordpress.org/plugin/tso-image-master.1.5.6.zip)
* [Details](https://mn.wordpress.org/plugins/tso-image-master/#description)
* [Reviews](https://mn.wordpress.org/plugins/tso-image-master/#reviews)
* [Installation](https://mn.wordpress.org/plugins/tso-image-master/#installation)
* [Development](https://mn.wordpress.org/plugins/tso-image-master/#developers)
[Support](https://wordpress.org/support/plugin/tso-image-master/)
## Description
TSO Image Master is a complete media management and image optimization plugin for
WordPress. It provides the following features from a single admin screen:
**Image Optimizer** — Convert images to WebP or JPG, set quality and dimensions,
replace originals and automatically update all content links. Supports bulk operations.
Requires the PHP GD library with WebP support.
**Orphaned Image Finder** — Detects images in the Media Library that are not referenced
in any post, page, widget, meta field, or theme customizer setting. Supports paginated
batch scanning to avoid timeouts on large sites.
**Rogue File Scanner** — Scans the uploads directory for physical files that WordPress
does not know about: double-extension files (e.g. image.jpg.webp), plugin backup
files, temporary files, and other unregistered images that waste disk space.
**SEO & File Names** — Edit title, alt text, caption, and description for any image.
Rename files using SEO-friendly slugs (lowercase, no accents, hyphens instead of
spaces). All internal links are updated automatically.
**PDF Compressor** — Reduce the file size of PDFs in the Media Library using GhostScript(
recommended) or the Imagick PHP extension as a fallback. The original URL never
changes.
**Auto-Optimizer** — Automatically optimize every new image on upload using the
configured format and quality. Uses a transient-based mechanism to ensure each image
is processed only once and regenerations do not trigger re-optimization.
**History** — Full audit log of all operations performed by the plugin: optimizations,
renames, SEO updates, PDF compressions, and reversions. Filterable by action type,
date range, and filename. Configurable automatic cleanup.
**URL Fixer** — Scans all posts and pages for broken image URLs caused by format
conversions (e.g. references to .jpg files that have been converted to .webp). Automatically
finds the correct replacement and updates the database in one click.
**Cache Compatibility** — After any operation that modifies file URLs or content,
the plugin automatically purges LiteSpeed Cache, WP Rocket, W3 Total Cache, and
WP Fastest Cache when they are active.
#### Requirements
* PHP 7.4 or higher (tested up to 8.3)
* WordPress 5.9 or higher (tested up to 6.9)
* PHP GD library with JPEG, PNG, GIF, and WebP support
* GhostScript (optional, required for PDF compression)
* Imagick PHP extension (optional, fallback for PDF compression)
#### Source Code
The source code for this plugin is entirely human-readable. The file `admin/js/admin.
js` is unminified, unobfuscated source code. No build tools are required. All translation
strings are passed from PHP via `wp_localize_script()`.
#### Translations
The plugin interface is already translated into the following languages (included
in the plugin):
* **English** — default
* **Català (Catalan)** — `ca`
* **Español (Spanish)** — `es_ES`
If you would like to contribute a translation into another language, you can do
so at [translate.wordpress.org](https://translate.wordpress.org/projects/wp-plugins/tso-image-master/).
## Screenshots
* [[
* Image Optimizer tab — media grid with bulk selection, output format, quality,
resize options, and modal editor for SEO, rename, and per-image optimization.
* [[
* PDF Compressor tab — list PDF attachments with compression status, quality settings,
and indicators for available engines (GhostScript / Imagick).
* [[
* URL Fixer tab — scan posts and pages for broken or obsolete image URLs after
format changes, review findings, and repair selected issues in one flow.
## Installation
1. Upload the `tso-image-master` folder to the `/wp-content/plugins/` directory, or
install it directly from the WordPress plugin dashboard.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Go to **Image Master** in the admin sidebar to start using the plugin.
4. (Optional) To enable PDF compression, install GhostScript on your server. Ask your
hosting provider for assistance if needed.
## FAQ
### Does the plugin modify original image files?
Only if you check the “Replace original” option. When replacing, the plugin saves
a backup copy in a dedicated folder inside your uploads directory: `wp-content/uploads/
tso-image-master/`. The backup file is named `originalname_tso_im_backup.ext`. You
can revert to the backup at any time from the editor modal, or delete it to free
disk space. Backup files are never stored inside the plugin folder.
### What happens to my images if I uninstall the plugin?
Uninstalling the plugin removes the following data:
* **Database:** plugin options, the custom history table (`wp_tso_im_history`),
all plugin postmeta keys, and scheduled cron events.
* **Backup folder:** the `wp-content/uploads/tso-image-master/` folder and all
backup copies inside it are deleted.
* **Original images:** your actual image files in the uploads folder are **never**
deleted. Only the plugin-created backup copies are removed.
### Does the plugin work with caching plugins?
Yes. After any operation that modifies content or file URLs, the plugin automatically
calls the purge functions of LiteSpeed Cache, WP Rocket, W3 Total Cache, and WP
Fastest Cache when they are installed and active.
### Can I use the plugin on a multisite installation?
The plugin has not been explicitly tested on multisite. It is designed for standard
single-site WordPress installations.
### The PDF compressor does not work. What should I do?
PDF compression requires GhostScript or the Imagick PHP extension to be available
on your server. The plugin indicates which engines are available at the top of the
PDF tab. Contact your hosting provider to install GhostScript for best results.
### I optimized an image and the new format weighs more than the original. What happened?
This can happen with images that are already well-optimized, very small images,
or images with a lot of transparency or detail. The plugin will show a warning in
this case. You can revert to the original using the backup.
## Reviews
There are no reviews for this plugin.
## Contributors & Developers
“TSO Image Master” is open source software. The following people have contributed
to this plugin.
Contributors
* [ deadko ](https://profiles.wordpress.org/deadko/)
[Translate “TSO Image Master” into your language.](https://translate.wordpress.org/projects/wp-plugins/tso-image-master)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/tso-image-master/),
check out the [SVN repository](https://plugins.svn.wordpress.org/tso-image-master/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/tso-image-master/)
by [RSS](https://plugins.trac.wordpress.org/log/tso-image-master/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
#### 1.5.6
* Updated: version bump to 1.5.6.
#### 1.5.5
* Fixed: sanitize manual rename input in AJAX handler to satisfy PHPCS while preserving
UTF-8 characters (e.g. ç, ñ).
#### 1.5.4
* Fixed: strict UTF-8 search behavior in image and PDF finders (no false positives
with characters like ñ).
* Fixed: manual image transform URL updates for encoded/non-encoded filenames with
accents and special characters.
* Fixed: URL Inconsistencies scan/fix handling for UTF-8 paths and encoded URLs.
* Fixed: History and Rogue dynamic UI language refresh after changing plugin language.
* Improved: mobile readability in Rogue and History sections (better card/table
layout on small screens).
#### 1.5.3
* Fixed: PDF compression flow now avoids long indefinite waits with a strict timeout
and faster polling.
* Added: automatic GhostScript-to-Imagick fallback in background PDF compression
when no output is produced in time.
* Added: pre-checks for encrypted/protected PDFs and already-compressed PDFs to
fail fast with clear feedback.
* Added: persistent “not compressible” PDF status with reason/timestamp, including
UI badge and disabled re-try button.
* Improved: timeout and error handling now refreshes PDF list immediately to reflect
status changes.
#### 1.5.2
* Added: auto-conversion source format selector in Auto-Optimizer settings (JPG/
JPEG, PNG, WEBP, GIF static-only, BMP, TIFF).
* Added: support for auto-optimizing static GIF, BMP and TIFF uploads when selected.
* Improved: robust GIF handling — animated GIFs are never auto-converted, with
fail-safe behavior if frame detection cannot be verified.
* Improved: broader mime support for TIFF/TIF detection in auto-optimizer.
* Fixed: consistency of “original format” behavior for BMP/TIFF in auto mode (now
safely skipped instead of unexpected fallback).
#### 1.5.1
* Fixed: complete in-plugin language switching (CA/ES/EN) for dynamic AJAX messages
and URL Fixer summaries/lists.
* Fixed: mixed-language residual strings after changing language from Catalan to
Spanish/English.
* Fixed: mobile header overlap/cropping in WordPress admin top bar.
* Improved: responsive layout for mobile tabs, header, and history/auto-history
table rendering.
#### 1.5.0
* Added: URL Fixer tab — scans and repairs broken image URLs in posts and pages.
* Added: Rogue File Scanner — detects unregistered files and double-extension backups.
* Added: base64-encoded path handling in rogue file deletion for correct UTF-8/
latin1 filesystem encoding.
* Added: TIPO B2 URL fix — detects thumbnails missing because of dimension suffix
renaming.
* Fixed: Auto-optimizer now uses a transient-based mechanism to prevent re-optimization
on internal regenerations.
* Fixed: PDF compression now updates `_wp_attachment_metadata[filesize]` for correct
display in WP 6.0+.
* Fixed: Rogue scanner path normalization for cross-platform compatibility.
* Improved: All i18n strings moved from JS JSON.parse to PHP `wp_localize_script()`.
* Improved: Inline CSS now uses `wp_add_inline_style()` instead of `echo '