Collection of Xcode project “tool” scripts
Ruby Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Collection of Ruby and Bash scripts that make your life easier.

What’s Inside

sync-resources / sync-resources.rb

The script in sync-resources.rb looks at your Xcode project, and finds a group named Resources. If it finds one, and the group itself is associated with a directory in your project — for example, Project/Resources — it will attempt to reconcile the contents of the directory with the contents of the group. Files added to the directory will be added to the Xcode group, and files no longer found will have their references removed.

It works well against projects with one single target. It’s possible to extend the script so it is more robust. The script uses the Xcodeproj gem from CocoaPods, and the appropriate Bundler magic is already set up for you.

Invoke sync-resources from the root-level directory containing your project.

Guard integration

If you’d like to invoke a resources sync whenever you’ve changed contents of the Resources directory, try using Guard. Create a Guardfile in your project which says something like this.

require 'guard/guard'

module ::Guard

  class InlineGuard < ::Guard::Guard

    def run_all

    def run_on_changes(paths)



guard 'inline-guard' do


    callback(:run_on_changes_end) {
        puts "Running `sync-resources`"


In this case, the InlineGuard is an empty shiv that allows us to register callbacks to filesystem changes. It tells guard to monitor for all the .png files in the Resources directory, and whenever there are changes, invoke sync-resources again.

It is supposed to live at the root level of your application project, and so it fearlessly hardcodes a lot of things, and makes assumptions about the project.

Place the Guardfile in the root-level directory containing your project, then invoke guard from there to enjoy automatic syncing.


The script in next-version bumps the version number by one. It works with Git Flow, the awesome branching model for software development, and AGVTool, Apple’s solution for software versioning.

It works pretty well if you are already using these tools. Remember to start this script from the develop branch, and it’ll make a new Git Flow release with the next version number.

Invoke next-version from the root-level directory containing your project.