{"id":13877554,"url":"https://github.com/wix/AppleSimulatorUtils","last_synced_at":"2025-07-16T13:32:02.676Z","repository":{"id":19416139,"uuid":"86659796","full_name":"wix/AppleSimulatorUtils","owner":"wix","description":"A collection of command-line utils for Apple simulators.","archived":false,"fork":false,"pushed_at":"2024-11-12T11:24:24.000Z","size":257,"stargazers_count":641,"open_issues_count":14,"forks_count":63,"subscribers_count":184,"default_branch":"master","last_synced_at":"2024-11-23T21:55:06.767Z","etag":null,"topics":["apple-simulators","ios","ios-simulator"],"latest_commit_sha":null,"homepage":"","language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wix.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-03-30T04:44:05.000Z","updated_at":"2024-11-19T05:59:26.000Z","dependencies_parsed_at":"2023-02-17T05:46:02.903Z","dependency_job_id":"4521c62a-5e94-4a39-97ea-306d9cf967b0","html_url":"https://github.com/wix/AppleSimulatorUtils","commit_stats":null,"previous_names":[],"tags_count":56,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wix%2FAppleSimulatorUtils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wix%2FAppleSimulatorUtils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wix%2FAppleSimulatorUtils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wix%2FAppleSimulatorUtils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wix","download_url":"https://codeload.github.com/wix/AppleSimulatorUtils/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226134226,"owners_count":17578778,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apple-simulators","ios","ios-simulator"],"created_at":"2024-08-06T08:01:08.029Z","updated_at":"2025-07-16T13:32:02.654Z","avatar_url":"https://github.com/wix.png","language":"Objective-C","readme":"# AppleSimulatorUtils\nA collection of utils for Apple simulators.\n\n## Deprecation Notice\n\n**AppleSimulatorUtils** remains an actively maintained project.\nHowever, we have deprecated certain functionalities that overlap with features provided by the **`xcrun simctl`** command in the latest **Command Line Tools for Xcode**. \nIn addition to avoid redundancy, it is better to use the **official** tool provided by Apple.\n\nFor a comprehensive list of deprecated commands and their `xcrun simctl` alternatives, please refer to our [Deprecations Document](./DEPRECATIONS.md).\n\n\n## Installing\n\nInstall [brew](https://brew.sh), then:\n\n```shell\nbrew tap wix/brew\nbrew install applesimutils\n```\n\n## Usage\n\n```\nA collection of utils for Apple simulators.\n\nUsage Examples:\n    applesimutils --byId \u003csimulator UDID\u003e --bundle \u003cbundle identifier\u003e --setPermissions \"\u003cpermission1\u003e, \u003cpermission2\u003e, ...\"\n    applesimutils --byName \u003csimulator name\u003e --byOS \u003csimulator OS\u003e --bundle \u003cbundle identifier\u003e --setPermissions \"\u003cpermission1\u003e, \u003cpermission2\u003e, ...\"\n    applesimutils --list [--byName \u003csimulator name\u003e] [--byOS \u003csimulator OS\u003e] [--byType \u003csimulator device type\u003e] [--maxResults \u003cint\u003e] [--fields \u003ckey1,key2,...\u003e]\n    applesimutils --booted --biometricEnrollment \u003cYES/NO\u003e\n    applesimutils --booted --biometricMatch\n\nOptions:\n    --byId, -id                   Filters simulators by unique device identifier (UDID)\n    --byName, -n                  Filters simulators by name\n    --byType, -t                  Filters simulators by device type\n    --byOS, -o                    Filters simulators by operating system\n    --booted, -bt                 Filters simulators by booted status\n\n    --list, -l                    Lists available simulators\n    --bundle, -b                  The app bundle identifier\n    --maxResults                  Limits the number of results returned from --list\n    --fields                      Comma-separated list of fields to include in --list output (e.g. \"udid,os,identifier\")\n\n    --setPermissions, -sp         Sets the specified permissions and restarts SpringBoard for the changes to take effect\n    --clearKeychain, -ck          Clears the simulator's keychain\n    --clearMedia, -cm             Clears the simulator's media\n    --restartSB, -sb              Restarts SpringBoard\n\n    --biometricEnrollment, -be    Enables or disables biometric (Face ID/Touch ID) enrollment.\n    --biometricMatch, -bm         Approves a biometric authentication request with a matching biometric feature (e.g. face or finger)\n    --biometricNonmatch, -bnm     Fails a biometric authentication request with a non-matching biometric feature (e.g. face or finger)\n\n    --version, -v                 Prints version\n    --help, -h                    Prints usage\n\nAvailable Permissions:\n    calendar=YES|NO|unset\n    camera=YES|NO|unset\n    contacts=YES|NO|unset\n    faceid=YES|NO|unset\n    health=YES|NO|unset (iOS/tvOS 12.0 and above)\n    homekit=YES|NO|unset\n    location=always|inuse|never|unset\n    medialibrary=YES|NO|unset\n    microphone=YES|NO|unset\n    motion=YES|NO|unset\n    notifications=YES|NO|critical|unset\n    photos=YES|NO|limited|unset (“limited” supported on iOS/tvOS 14.0 and above)\n    reminders=YES|NO|unset\n    siri=YES|NO|unset\n    speech=YES|NO|unset\n    userTracking=YES|NO|unset (iOS/tvOS 14.0 and above)\n```\n\n## Troubleshooting\n\n- In case an installation fails, make sure to update your command line tools in the System Update system preference pane of your Mac\n- If Homebrew complains about a conflict in the `wix/brew` tap, run `brew untap wix/brew \u0026\u0026 brew tap wix/brew` and try installing again\n- If installation still fails, **run `brew doctor` and fix all issues \u0026 warnings**\n\n### Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for more information.\n","funding_links":[],"categories":["Objective-C","Help, tricks, issues"],"sub_categories":["Settings"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwix%2FAppleSimulatorUtils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwix%2FAppleSimulatorUtils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwix%2FAppleSimulatorUtils/lists"}