Manual:CleanupImages.php

cleanupImages.php is a maintenance script located in the maintenance directory that can be used to clean up broken or unparseable upload filenames. The edits will be attributed to the user called Conversion script.

Technical details
These notes are based on an inspection of cleanupImages.php from MediaWiki 1.19.

Problematic names
Image names containing the following elements are candidates for name replacement:
 * percent codes
 * HTML entities
 * deprecated Latin-1 characters
 * non-normalized Unicode

Replacement names
When encountering a problematic image name, the script will attempt to automatically derive a safe name. If the derived name comes up empty (perhaps there is nothing left after removal of unsafe characters) or the derived name matches the name of another image which already exists, the problematic image file will be skipped without name replacement.