Skip to content
Back to search

simutil

Utilities for Android emulators, iOS simulators and real devices: launch, stream, control, record and automate them from a desktop app, TUI and CLI

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dungngminh--simutil/badge.svg)](/listings/dungngminh--simutil)

HTML

<a href="/listings/dungngminh--simutil"><img src="/api/listings/dungngminh--simutil/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

SimUtil Desktop

Installers are on the [releases page](https://github.com/dungngminh/simutil/releases?q=app-v) (`app-v*` tags). The app updates itself in place from where you installed it.

**macOS** (Monterey or later; pulls in `adb` and `ffmpeg`):

brew update
brew tap dungngminh/simutil
brew install --cask simutil-desktop

Or download `SimUtil-macos.dmg` and drag SimUtil into Applications.

**Windows**: run `SimUtil-windows-x64-setup.exe` from the [latest desktop release](https://github.com/dungngminh/simutil/releases?q=app-v). The installer offers to install Android platform-tools and FFmpeg.

**Linux** (x86_64 AppImage; installs `adb`, `ffmpeg` and FUSE, re-run to update):

curl -fsSL https://raw.githubusercontent.com/dungngminh/simutil/main/app/packaging/linux/install.sh | bash

More, including the MCP tool list: [app/README.md](app/README.md).

`simutil` CLI

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/dungngminh/simutil/main/install.sh | bash

# Homebrew
brew tap dungngminh/simutil && brew install simutil

# pub.dev
dart pub global activate simutil

Windows (PowerShell):

powershell -ExecutionPolicy Bypass -Command "iwr -useb https://raw.githubusercontent.com/dungngminh/simutil/main/install.ps1 | iex"

`simutil upgrade` updates it the same way you installed it. simutil checks for a new release at most once a day; set `SIMUTIL_NO_UPDATE_CHECK=1` to turn that off.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 208 lines · 3 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="art/simutil.png" alt="SimUtil" width="200" />
  3. </p>
  4. <h1 align="center">SimUtil</h1>
  5. <p align="center">
  6. <strong>Everyday utilities for Android emulators, iOS simulators and real devices</strong><br>
  7. Launch, stream, control, record, test and clean up, from one desktop app or the command line.
  8. </p>
  9. <p align="center">
  10. <a href="https://www.producthunt.com/products/simutil?embed=true&amp;utm_source=badge-featured&amp;utm_medium=badge&amp;utm_campaign=badge-simutil" target="_blank" rel="noopener noreferrer"><img alt="SimUtil on Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1111003&amp;theme=light&amp;t=1774974338508"></a>
  11. </p>
  12. <p align="center">
  13. <img src="https://img.shields.io/github/stars/dungngminh/simutil" alt="GitHub Repo stars" />
  14. <a href="https://github.com/dungngminh/simutil/actions/workflows/ci.yaml"><img src="https://github.com/dungngminh/simutil/actions/workflows/ci.yaml/badge.svg" alt="Build" /></a>
  15. <a href="https://github.com/dungngminh/simutil/releases?q=app-v"><img src="https://img.shields.io/github/v/release/dungngminh/simutil?filter=app-v*&label=Desktop" alt="Desktop release" /></a>
  16. <a href="https://github.com/dungngminh/simutil/releases?q=cli-v"><img src="https://img.shields.io/github/v/release/dungngminh/simutil?filter=!app-v*&label=CLI" alt="CLI release" /></a>
  17. </p>
  18. Mobile development means juggling Android Studio, Xcode, `adb`, `simctl`,
  19. scrcpy and a pile of scripts just to get a device up and look at it.
  20. SimUtil puts those chores in one place, without opening an IDE:
  21. - **SimUtil Desktop** — stream and control many devices side by side
  22. (emulators, simulators, real Android phones and real iPhones / iPads), record
  23. them, run scenarios across them, and let AI agents drive them over MCP.
  24. - **`simutil` CLI** — list, launch and shut down devices, connect over Wi-Fi,
  25. read Logcat and run your own tools from scripts or the terminal.
  26. - **Dart packages** — the same device services (`adb`, `simctl`, `devicectl`)
  27. as libraries for your own tooling.
  28. Runs on macOS, Linux and Windows. iOS features need macOS (Xcode).
  29. <p align="center">
  30. <img src="https://github.com/user-attachments/assets/2ffebae8-f22d-4b66-8fbe-e2e2e39c202f" alt="SimUtil Desktop" />
  31. </p>
  32. https://github.com/user-attachments/assets/b0463741-6d31-496d-99a8-264a5e69457a
  33. <p align="center">
  34. <img src="art/showcase-simutil.gif" width="100%" alt="simutil interactive device picker" />
  35. </p>
  36. <p align="center">
  37. <img src="art/showcase.png" alt="simutil interactive device picker" />
  38. </p>
  39. ## Utilities
  40. | | Utility | Desktop | CLI |
  41. | --- | --- | :---: | :---: |
  42. | **Devices** | Start / stop emulators and simulators, headless or with their window | ✓ | ✓ |
  43. | | Android launch options: cold boot, no audio | ✓ | ✓ |
  44. | | Wipe data or delete an emulator / simulator | ✓ | |
  45. | | Slim iOS simulators (about 1 GB of memory instead of 4 GB) | ✓ | |
  46. | **Stream & control** | Many devices side by side, grid or spotlight layout | ✓ | |
  47. | | Real Android phones over USB or Wi-Fi | ✓ | |
  48. | | Touch, swipe, navigation buttons and keyboard typing on every stream | ✓ | |
  49. | | Real iPhones / iPads connected by USB: device frame, screenshots, recording with sound (view only, macOS) | ✓ | |
  50. | | Built-in scrcpy server, no separate install | ✓ | |
  51. | **Connect** | Wireless ADB by QR code, pairing code or IP | ✓ | ✓ |
  52. | **Capture** | Screenshot one device or the whole grid | ✓ | |
  53. | | Record one device or the whole grid (native 60 fps on macOS) | ✓ | |
  54. | **Apps** | Install by dropping an `.apk` / `.app` / `.ipa` on a device | ✓ | |
  55. | | Convert an iPhone build so it runs on a simulator (Apple Silicon) | ✓ | |
  56. | **Test & automate** | Scenario studio: YAML steps (tap by label, swipe, type, assert) on many devices at once | ✓ | |
  57. | | MCP server for Claude Code, Codex, Cursor, Gemini CLI, VS Code | ✓ | |
  58. | | JSON output and a full command schema for scripts and agents | | ✓ |
  59. | **Debug** | Logcat with filtering | | ✓ |
  60. | | Custom tools (scrcpy, Maestro, scripts) as YAML plugins | | ✓ |
  61. | **Clean up** | Clear Xcode DerivedData after a size preview (macOS) | ✓ | ✓ |
  62. ## Install
  63. ### SimUtil Desktop
  64. Installers are on the [releases page](https://github.com/dungngminh/simutil/releases?q=app-v)
  65. (`app-v*` tags). The app updates itself in place from where you installed it.
  66. **macOS** (Monterey or later; pulls in `adb` and `ffmpeg`):
  67. ```bash
  68. brew update
  69. brew tap dungngminh/simutil
  70. brew install --cask simutil-desktop
  71. ```
  72. Or download `SimUtil-macos.dmg` and drag SimUtil into Applications.
  73. **Windows**: run `SimUtil-windows-x64-setup.exe` from the
  74. [latest desktop release](https://github.com/dungngminh/simutil/releases?q=app-v).
  75. The installer offers to install Android platform-tools and FFmpeg.
  76. **Linux** (x86_64 AppImage; installs `adb`, `ffmpeg` and FUSE, re-run to update):
  77. ```bash
  78. curl -fsSL https://raw.githubusercontent.com/dungngminh/simutil/main/app/packaging/linux/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 98 on GitHub
  79. ```
  80. More, including the MCP tool list: [app/README.md](app/README.md).
  81. ### `simutil` CLI
  82. ```bash
  83. # macOS / Linux
  84. curl -fsSL https://raw.githubusercontent.com/dungngminh/simutil/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 107 on GitHub
  85. # Homebrew
  86. brew tap dungngminh/simutil && brew install simutil
  87. # pub.dev
  88. dart pub global activate simutil
  89. ```
  90. Windows (PowerShell):
  91. ```powershell
  92. powershell -ExecutionPolicy Bypass -Command "iwr -useb https://raw.githubusercontent.com/dungngminh/simutil/main/install.ps1 | iex"
  93. ```
  94. `simutil upgrade` updates it the same way you installed it. simutil checks for
  95. a new release at most once a day; set `SIMUTIL_NO_UPDATE_CHECK=1` to turn that off.
  96. ## CLI usage
  97. ```bash
  98. simutil list -v # devices on every platform, grouped
  99. simutil list --json # for scripts and agents
  100. simutil launch <device-id> # boot (alias: start)
  101. simutil launch <id> -c --no-audio # cold boot, no audio (Android)
  102. simutil launch <id> --headless # no emulator window / Simulator app
  103. simutil shutdown <device-id> # alias: stop
  104. simutil wipe <device-id> # erase data of a shut-down device (asks y/N)
  105. simutil delete <device-id> -y # delete it; -y skips the prompt
  106. simutil android device list -r # running adb devices only
  107. simutil plugin run scrcpy mirror -d emulator-5554
  108. simutil schema # every command as JSON, for agents
  109. ```
  110. Run `simutil` with no arguments for an interactive device picker with ADB
  111. tools, Logcat and plugins. `simutil <command> --help` lists each command's flags.
  112. ### Plugins
  113. Wire external tools (scrcpy, Maestro, your own scripts) to a device in
  114. `~/.simutil/settings.yaml`, no code changes needed:
  115. ```yaml
  116. plugins:
  117. - id: scrcpy
  118. label: scrcpy
  119. availability:
  120. command: scrcpy
  121. args: [--version]
  122. commands:
  123. - id: mirror
  124. label: Screen Mirror
  125. command: scrcpy
  126. args: [-s, "{device.id}"]
  127. platforms: [android]
  128. requires_running: true
  129. ```
  130. Full reference: [docs/plugins.md](docs/plugins.md).
  131. ## Supported platforms
  132. | Host OS | Android emulators & devices | iOS simulators & devices |
  133. | ------- | --------------------------- | ------------------------ |
  134. | macOS | Yes | Yes (requires Xcode) |
  135. | Linux | Yes | No |
  136. | Windows | Yes | No |
  137. iOS support uses Apple's tools (`xcrun simctl`, `xcrun devicectl`), which only
  138. exist on macOS. On Xcode 27+, a simulator opens in DeviceHub.app; earlier
  139. versions use Simulator.app.
  140. ## Packages
  141. Monorepo (pub workspace); each package is versioned and published separately:
  142. | Package | Contents |
  143. | ------- | -------- |
  144. | [`app`](app) | SimUtil Desktop: multi-device streaming, recording, scenarios, MCP server |
  145. | [`simutil`](packages/simutil) | The `simutil` CLI |
  146. | [`simutil_core`](packages/simutil_core) | Models, `CommandExec`, `DeviceService` |
  147. | [`simutil_adb`](packages/simutil_adb) | Android: devices, wireless ADB, scrcpy session, Logcat |
  148. | [`simutil_apple`](packages/simutil_apple) | Apple: simulators, physical devices, Xcode cache |
  149. | [`simutil_plugins`](packages/simutil_plugins) | YAML plugin catalog and runner |
  150. | [`simutil_shared`](packages/simutil_shared) | Shared app layer: settings, app state, changelog |
  151. | [`simutil_h264`](packages/simutil_h264) | Native H.264 decoding into Flutter textures |
  152. ## Contributing
  153. ```bash
  154. git clone https://github.com/dungngminh/simutil.git
  155. cd simutil
  156. flutter pub get # whole workspace, desktop app included
  157. dart run melos run check # analyze + Dart and Flutter tests
  158. cd app && flutter run -d macos
  159. ```
  160. Fork, branch, open a Pull Request. Architecture notes: [docs/ai/architecture.md](docs/ai/architecture.md).
  161. ## License
  162. MIT — see [LICENSE](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.