Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Robot Framework Automation Library for iOS
Python AppleScript



robotframework-ioslibrary is a Robot Framework test library for all your iOS automation needs.

It uses Calabash iOS Server to communicate with your instrumented iOS application similar to how Selenium WebDriver talks to your web browser.


To install, just fetch the latest version from PyPI:.

pip install --upgrade robotframework-ioslibrary

Prepare your iOS app

To prepare your iOS app look at <>

Install Waxsim

To get full simulator support, e.g.: for testing in app purchases you have to install waxsim.

Download the source from:

change into the directory and build it with:


Then add the binary to your path

Simulator Reset

To use Reset Simultor enable:

System preferences -> Accesability -> Enable access for Assisted devices


API documentation can be found at, here is an example on how to use it:

Setting Value
Library IOSLibrary

Test Case Action Argument Argument Argument
[Documentation] Starts the iOS Simulator and swipes    
Set Device URL localhost:37265    
Start Simulator      
Wait Until Keyword Succeeds 1 minute 5 seconds Is Device Available
Swipe right    
Rotate left    
Screen Should Contain Hello World    


robotframework is a port of the ruby-based calabash-ios and therefore licensed under the Eclipse Public License (EPL) v1.0

Development by Lovely Systems GmbH, sponsored by Axel Springer AG.

Something went wrong with that request. Please try again.