Command Line Launcher for the iPhone Simulator
Objective-C Ruby C
Switch branches/tags
Nothing to show
Clone or download
Latest commit 368ec28 Jul 28, 2015

WARNING: This project is no longer supported. Please check out for replacement that works with the latest XCode.


The ios-sim tool is a command-line utility that launches an iOS application on the iOS Simulator. This allows for niceties such as automated testing without having to open XCode.

This fork fixes a dynamic loading problem when running Xcode 4.3. To use:

  1. Download the ios-sim-xcode43.tar.gz file from the Download section above.
  2. Extract the ios-sim executable and copy it to TITANIUM_HOME/mobilesdk/osx/1.8.1/iphone/ios-sim.
  3. Make sure you have run "sudo xcode-select -switch /Applications/" to set the new path to the developer tools.

Clean your build directory and rebuild!


  • Choose the device family to simulate, i.e. iPhone or iPad.
  • Setup environment variables.
  • Pass arguments to the application.
  • See the stdout and stderr, or redirect them to files.

See the --help option for more info.


Through homebrew:

$ brew install ios-sim

Download an archive:

$ curl -L -o
$ unzip

Or from a git clone:

$ git clone git://

Then build and install from the source root:

$ rake install prefix=/usr/local/


Original author: Landon Fuller Copyright (c) 2008-2011 Plausible Labs Cooperative, Inc. All rights reserved.

This project is available under the MIT license. See LICENSE.