Search and delete unused Xcode assets
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Simple script to search your Xcode project for unused images

I know there are tools for this out there, but some aren't reliable and some are $30, albeit with more options. But if you want something simple, just for searching, deleting and seeing at a glance what @2x/@1x assets are missing, this should do the trick.

It takes an argument, so you should run it like ruby unused.rb /path_to_your_project_folder. If you don't provide an argument, you will be prompted for one after launching.

It searches m, mm, cpp, c, h and html files by default. Easily changeable.

Default searched files are jpg, png, jpeg, tiff, tif, gif, bmp, BMPf, ico, cur, xbm, since these are the ones supported by the iOS SDK. Easily changeable.

It provides easily changeable exclusions, the defaults being:

excluded_folders = ['vendor', '.appiconset', '.launchimage']
excluded_images = []
imagesets = ['.imageset']
  • Excluded folders will not be searched for images to be removed, but files inside them will be searched for occurrences of images. Best example: exclude external classes that might contain their own images, but they might be also customized with your own graphics.
  • Excluded images will not be searched for.
  • Add all your imagesets to imagesets, I'm using only one.

You will be displayed a list of unused file names, then a list of to-be deleted files, with full paths. You can choose to stop here, delete them all, or delete them one by one.

Since it shows a list of file names, you can also see at glance what images are missing @2x or @1x sizes.

It removes references of the deleted files from your .pbxproj file. .imagesets are automatically handled by Xcode.

I tested it and re-tested it and there's a one-by-one mode, please don't go delete everything if you're not 100% sure of what you're doing.

That's about it. Please feel free to improve or contact me for any questions; I'd be more than happy to hear from you.


Licensed under MIT.