Latest 2.0.1
License MIT
Platforms osx 10.10, requires ARC
Dependencies Shell

📱 Simulator

A simctl wrapper in Swift.

code style: prettier

Install 🛠

Using CocoaPods

Add the following line to your Podfile and run pod install:

pod "Simulator", "~> 2.0.1"

Using Swift Package Manager

Add the following dependency to your Package.swift:

.package(url: "", .upToNextMinor(from: "2.0.1")),

Using Carthage

Add the following line to your Cartfile and link the Simulator.framework from the project:

github "angledotdev/simulator" ~> 2.0.1

Note: Simulator is only compatible with macOS

Using Marathon

If you want to use Simulator in a Marathon script, either add it to your Marathonfile (see the Marathon repo for instructions on how to do that), or point Marathon to Simulator using the inline dependency syntax:

import Simulator //

Usage 🚀


// List devices
let devices = try Device.list

// Launch simulator
try device.launch()

// Wait until the simulator is launched
try device.wait(until: { $0.isBooted })

// Install an app
let appPath = URL(fileURLWithPath: "/path/")
try device.install(appPath)

// Uninstall an app
try device.uninstall("io.angledotdev.App")

// Erase the device content
try device.erase()

// Get device runtime
let runtime = try device.runtime()
let runtimeVersion = runtime.version


// List runtimes
let runtimes = try Runtime.list

// Get the latest runtime
let latestiOS = try Runtime.latest(platform: .iOS)

Setup for development 👩‍💻

  1. Git clone: [email protected]:angledotdev/simulator.git
  2. Generate Xcode project with swift package generate-xcodeproj.
  3. Open Simulator.xcodeproj.
  4. Have fun 🤖

Latest podspec

    "name": "Simulator",
    "version": "2.0.1",
    "summary": "Interact with the Xcode simulators",
    "homepage": "",
    "social_media_url": "",
    "license": "MIT",
    "source": {
        "git": "",
        "tag": "2.0.1"
    "requires_arc": true,
    "authors": "Angle",
    "swift_version": "5.0",
    "platforms": {
        "osx": "10.10"
    "source_files": "Sources/**/*.{swift}",
    "dependencies": {
        "Shell": [
            "~> 2.0.3"

Pin It on Pinterest

Share This