dungngminh/simutil
60.7
Adequate · 5 November 2026
28.7k
lines of production code
Dart
with Swift
4
measurements over time
What this system is
Features
Android device management and scrcpy streaming library (simutil\_adb 1.3.0)
The new \simutil\_adb\ package provides Android device and emulator management via ADB and scrcpy streaming. It introduces wireless ADB pairing (including QR code pairing and mDNS discovery) and a \watchDevices()\ API that uses \adb track-devices\ instead of polling. The \ScrcpySession\ streams H.264 video on a background isolate, supports keyboard input, key codes, and display power options, and fails the stream with a 'Device disconnected' status if the server process exits. \AndroidAutomation\ handles app installation (\adb install -r -t\), launching, typing, and UI element tapping. Device listings now include the Android version, and ADB resolution falls back to Homebrew and WinGet paths.
_packages/simutil\adb · high confidence
Initial desktop support for Linux and Windows
The SimUtil desktop application is now available on Linux and Windows, enabling users to run the app natively on their desktops. This release adds the necessary build configurations (CMake) and platform-specific entry points for both operating systems, integrating core plugins such as desktop file dropping, window management, and H.264 streaming support.
app/linux, app/windows · high confidence
Initial release of the simutil\_h264 Flutter plugin
The \simutil\_h264\ package is introduced as a new Flutter plugin that decodes H.264 Annex-B video streams into native Flutter textures. It supports macOS (VideoToolbox), Windows (Media Foundation), and Linux (libavcodec/FFmpeg). The plugin exposes an \H264Decoder\ class for standard usage and provides a \decodeFunction\ (via \dart:ffi\) to allow offloading decoding to worker isolates, which is essential for the SimUtil desktop app's multi-device streaming performance.
_packages/simutil\h264 · high confidence
Introduce macOS desktop app for iOS device and simulator streaming
The macOS desktop application (SimUtil) is now available, enabling users to stream the screens of connected iPhones and iPads over USB and live iOS simulators directly to the desktop. This release adds native Swift plugins for device capture (DeviceStream), simulator frame capture (SimStream), and window recording (WindowRecorder), along with the necessary Xcode project structure, entitlements for screen capture and private framework access, and Flutter plugin registrations to support these capabilities.
app/macos · high confidence
Shared app layer for settings, state, and update checking
The \simutil\_shared\ library now provides the core application logic shared between the TUI and GUI, including user settings (theme, last device), persisted app state (last seen version, update check timestamps), a changelog viewer, device change watching, and an update checker that detects the install source (Homebrew, pub.dev, install script, PowerShell) to provide the correct upgrade command.
_packages/simutil\shared/lib · high confidence
SimUtil Apple package introduces simulator and device management APIs
The new \simutil\_apple\ package provides a comprehensive set of APIs for managing iOS simulators and physical devices on macOS. It enables listing and watching connected devices via FSEvents and usbmuxd, installing \.app\ or \.ipa\ bundles on both simulators and hardware, and launching apps with state-clearing options. A key feature is the ability to convert device-only builds to run on Apple Silicon simulators by re-tagging Mach-O binaries and re-signing them. The package also includes utilities for recording simulator screens, slimming simulator memory usage by disabling background daemons, and clearing Xcode Derived Data.
_packages/simutil\apple · high confidence
SimUtil CLI and TUI package introduction
This change introduces the \simutil\ package, providing a terminal UI and CLI for managing Android emulators and iOS simulators. Users can now list, launch, and shut down devices, as well as wipe or delete emulator data. The CLI supports platform-specific commands (Android/iOS), JSON output for scripting, and an upgrade command. The package is structured into sub-packages (\simutil\_core\, \simutil\_adb\, etc.) and includes a changelog documenting versions from 0.2.0 to 1.2.0.
packages/simutil · high confidence
SimUtil core library extracted with device automation and process execution
The \simutil\_core\ package has been introduced as a standalone library (v1.0.0) extracted from the main SimUtil app, providing shared models and process execution capabilities for other SimUtil packages. It introduces \DeviceAutomation\ for installing apps, launching them, typing text, and interacting with the accessibility tree, as well as \DeviceService\ for managing device lifecycle events like wiping data and deleting simulators. The package also includes \CommandExec\ and \IsolateRunner\ for running shell commands with bounded concurrency and priority scheduling, ensuring that interactive user actions are not blocked by background polling. Additionally, it provides \DeviceSession\ for live device screen streaming and input, along with test doubles like \FakeCommandExec\ and \FakeDeviceService\ to support testing.
_packages/simutil\core · high confidence
SimUtil desktop app initial release with multi-device streaming and MCP automation
The SimUtil desktop application is now available for macOS, Windows, and Linux, providing a unified interface to manage and stream Android emulators/devices and iOS simulators. The app features real-time device streaming, automated device management (booting, shutting down, slim mode for iOS), and an embedded Model Context Protocol (MCP) server that exposes tools for external agents to list devices, capture screenshots, record grids, and drive input (tap, type, install) across connected devices. It also includes a debug log panel, scenario execution capabilities, and automatic in-place updates.
app/lib · high confidence
SimUtil desktop app initial release with multi-device streaming and installers
The SimUtil desktop app (macOS, Windows, Linux) is now available, enabling users to stream and control multiple Android emulators/devices and iOS simulators side-by-side in a grid or spotlight layout. Key capabilities include per-device input (touch, swipe, keyboard), recording (single device or grid), and an MCP server for automation. This release also introduces in-app self-updates, persistent settings, and native installers (DMG/Homebrew, Windows .exe/winget, Linux AppImage) that bundle required tools like adb and FFmpeg.
app · high confidence
SimUtil initial release with cross-platform TUI and CLI
SimUtil is now available as a cross-platform terminal UI and CLI for launching Android emulators and iOS simulators. The tool supports macOS, Linux, and Windows, with iOS features restricted to macOS. Key capabilities include one-key device launching, wireless ADB pairing (IP, 6-digit code, and QR), a built-in Logcat viewer, and a YAML-based custom plugin system for external tools like scrcpy. Installation is supported via binary install scripts, Homebrew, and pub.dev.
(repo-wide) · high confidence
Behavioural changes
Enhanced terminal state management for Linux and macOS
The CLI entry point now implements a supervisor process on Linux and macOS to better manage terminal state. It captures the terminal settings before launching the TUI, forwards signals (SIGINT, SIGHUP, SIGTERM, SIGWINCH) to the child process, and restores the original terminal state upon exit, which improves reliability when using the tool over SSH or in complex terminal environments.
bin · high confidence
Removed unused simutil.dart file
The lib/simutil.dart file, which contained a single unused calculate function, has been removed from the codebase.
lib · high confidence
Test coverage
Added comprehensive test coverage for the desktop app; Added unit tests for SimUtil shared package components.
Dependencies
SimUtil workspace restructured into a monorepo with updated dependencies
The project has been reorganized into a pub workspace (monorepo) managed by Melos, splitting the code into independent packages: simutil\_core, simutil\_adb, simutil\_apple, simutil\_plugins, simutil\_shared, simutil (TUI/CLI), simutil\_h264, and the simutil\_app desktop app. This structural change is accompanied by dependency updates across the workspace, including upgrading the Dart SDK constraint to ^3.11.0 and Flutter to \>=3.38.0, and updating internal package versions (e.g., simutil\_adb to 1.3.0, simutil\_apple to 1.3.1, simutil\_shared to 1.1.0). Transitive dependencies in pubspec.lock have also been updated, such as analyzer to 10.2.0 and archive to 4.5.2.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 61 → 61 (-0.2)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 79 → 80 (+0.1)
- Architecture 95 → 95 (-0.3)
- Maturity 72 → 79 (+6.9)
- Readiness 51 → 51 (+0.0)
- Security 76 → 69 (-7.5)
- Performance 62 → 62 (+0.0)
Resolved (2)
- Duplicated block (14 lines × 2) (packages/simutil/lib/src/cli/commands/launch_command.dart)
- Split app
New (7)
- Duplicated block (14 lines × 2) (packages/simutil_apple/lib/src/ios_automation.dart)
- Duplicated block (5 lines × 2) (packages/simutil_adb/lib/src/emulator/emulator_grpc_session.dart)
- Duplicated block (9 lines × 2) (packages/simutil_h264/macos/simutil_h264/Sources/simutil_h264/H264Stream.swift)
- EmulatorEndpoint.find (cognitive 17) (packages/simutil_adb/lib/src/emulator/emulator_endpoint.dart)
- Hotspot: app/lib/src/ui/streams/stream_tile.dart (app/lib/src/ui/streams/stream_tile.dart)
- Low cohesion: _ToastFeedsState (LCOM4 4) (app/lib/src/ui/recording_toast.dart)
- Projects may be oversized for their cohesion
Changes since last survey
- 9 commits — 7 feature/other, 2 fixes
By area
- app/lib — 3 commits
- packages/simutil_adb — 3 commits
- app/CHANGELOG.md — 1 commit
- app/macos — 1 commit
- packages/simutil_apple — 1 commit
Notable commits
- fix: fix(app): device window toast, failed pop-out and quit guards
- fix: fix: smooth and reliable headless Android emulator streams
- change: chore(app): bump 0.5.0
- change: feat(app): camera for iOS simulator apps (webcam, image, video)
- change: feat(app): open a device stream in its own window
- change: feat(app): stream Android emulators over the emulator's gRPC API
- change: feat: list iPhones and iPads over usbmuxd + lockdown
- change: feat: pick Android emulator camera source (webcam, image, video)
- change: feat: switch emulator camera from a running stream
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
dungngminh/simutil was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 5 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 19654090275584fa3d725e526d5bb058f3f8d7bf — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.2+preprod-5c4e66d9318b.