Baguette

Bon appétit.

Headless iOS Simulator manager + host-side input injection for iOS 26.

A single Swift CLI — **`baguette`** — that creates / boots / shuts down simulator devices, streams their screens at 60 fps, and injects taps / swipes / multi-finger touches without booting the Simulator.app GUI. Optionally serves a self-contained web UI on `localhost` so you can control any booted simulator from a browser. ## Demo https://github.com/user-attachments/assets/e904413f-16bb-4b3d-86d5-162333403cee https://github.com/user-attachments/assets/c49c9f4b-0e4b-47ea-9272-3223b1ac7739 https://github.com/user-attachments/assets/65dc62ee-f0c7-48fb-9c57-5bd267c8c02f > The raw clip lives at [`assets/demo.mp4`](assets/demo.mp4) — drag > it into a GitHub web edit of this README to upload as a CDN-hosted > video and replace the line above with the auto-generated URL. - **Frame streaming** — MJPEG or H.264 / AVCC over stdout or WebSocket. Runtime-tunable bitrate / fps / scale. - **Host-HID input** — taps / swipes / streaming 1- and 2-finger gestures / home & lock buttons / scroll wheel, all through SimulatorKit's 9-argument `IndigoHIDMessageForMouseNSEvent` from Xcode 26's preview-kit. No dylib injection, no `DYLD_INSERT_LIBRARIES`, no per-app priming. - **Standalone web UI** — `baguette serve` opens `http://localhost:8421/simulators` with a list page, live stream, gesture input, and DeviceKit-sourced bezels for every simulator family. - **Device farm** — `http://localhost:8421/farm` is an interactive multi-device dashboard. Every booted simulator streams in a wall / grid / list, with filtering and sorting; click a tile to focus it for full-quality streaming + gesture and hardware-button input through the same `GestureDispatcher` → `IndigoHIDInput` pipeline as the CLI. - **Layered, test-driven** — bounded-context Domain / Infrastructure / App split; 110+ Mockable-backed tests; `swift test` runs without a booted simulator. ## Install ```bash brew install tddworks/tap/baguette ``` Apple Silicon only. Requires Xcode 26 — `baguette` links against private SimulatorKit / CoreSimulator frameworks shipped with Xcode. ## Quickstart ```bash # Start the web UI baguette serve # Single-device dashboard — list, boot/shutdown, per-device stream pages open http://localhost:8421/simulators # Device farm — every booted simulator side-by-side, click to focus open http://localhost:8421/farm ``` `/simulators` lists every simulator on the machine with Boot / Shutdown buttons; click any booted device to open its Stream page — live frames, mouse/touch input, and the DeviceKit-sourced bezel. `/farm` is the multi-device control surface. See [Device farm](#device-farm) below. Headless from the terminal works too: ```bash baguette list baguette boot --udid baguette tap --udid --x 219 --y 478 --width 438 --height 954 ``` ## Build from source ```bash make # release build via ./build.sh swift test # run the test suite ``` Hybrid build: SPM fetches dependencies (`ArgumentParser`, `Mockable`, `Hummingbird`, `HummingbirdWebSocket`); `swiftc` compiles everything with an Objective-C bridging header targeting `arm64e-apple-macos26.0`, linking `CoreSimulator`, `SimulatorKit`, `IOSurface`, `VideoToolbox`, `CoreGraphics`, `ImageIO` from Xcode's private frameworks. ## CLI ``` baguette [options] list [--json] List devices (default + custom sets; --json emits {"running":[…],"available":[…]}) boot --udid Boot headlessly shutdown --udid Shutdown stream --udid [--fps 60] [--format mjpeg|avcc] Stream frames on stdout screenshot --udid [--output ] [--quality 0.85] [--scale 1] Capture one JPEG frame (defaults to stdout) input --udid Read JSON gestures from stdin # Standalone web UI on localhost. Serves /simulators (single-device # dashboard) and /farm (multi-device dashboard) — both backed by the # same WS endpoint and HID pipeline. serve [--port 8421] [--host 127.0.0.1] [--device-set ] # DeviceKit chrome / bezel data. chrome layout --udid Print bezel layout JSON chrome composite --udid Write composite PNG to stdout chrome layout --device-name "iPhone 17 Pro" chrome composite --device-name "iPhone 17 Pro" # One-shot gestures — same HID path as `input`, one gesture per # invocation. Coordinates are in DEVICE POINTS; `width` / `height` # are the simulator's screen size in points. tap --udid … --x … --y … --width … --height … [--duration 0.05] swipe --udid … --startX … --startY … --endX … --endY … --width … --height … pinch --udid … --cx … --cy … --startSpread … --endSpread … --width … --height … pan --udid … --x1 … --y1 … --x2 … --y2 … --dx … --dy … --width … --height … press --udid … --button home|lock ``` ## `baguette serve` — the web UI ```bash baguette serve --port 8421 # [baguette] listening on http://127.0.0.1:8421/simulators ``` Open `http://localhost:8421/simulators` in any browser. You get the device list (RUNNING / AVAILABLE sections), Boot / Shutdown buttons, and a Stream page per device with live frames + gesture input + the DeviceKit-sourced bezel. The HTML is editable on disk — `Sources/Baguette/Resources/Web/sim.html` opens directly in any browser via `file://` (preview mode), and points to its sibling `.js` files. Set `BAGUETTE_WEB_DIR` to override the served root for live-iteration without rebuilding. ### Routes (single resource tree, no `/api/` prefix) | Method | Path | Backed by | |--------|--------------------------------------------|------------------------------| | `GET` | `/` | 302 → `/simulators` | | `GET` | `/simulators` | list HTML | | `GET` | `/simulators.json` | list JSON `{running, available}` | | `GET` | `/simulators/:udid` | stream HTML | | `POST` | `/simulators/:udid/boot` | `simulator.boot()` | | `POST` | `/simulators/:udid/shutdown` | `simulator.shutdown()` | | `GET` | `/simulators/:udid/chrome.json` | DeviceKit bezel layout | | `GET` | `/simulators/:udid/bezel.png` | rasterized bezel PNG | | `GET` | `/simulators/:udid/screenshot.jpg` | one-shot JPEG of the framebuffer (`?quality=&scale=`) | | `WS` | `/simulators/:udid/stream?format=mjpeg|avcc` | live frames + control + input | | `GET` | `/farm` | device-farm HTML | | `GET` | `/farm/:file` | farm UI asset (`farm.css`, `farm-*.js`, …) | | `GET` | `/.{html,js,css}` | static UI asset | ### One bidirectional WebSocket per stream The same WS carries everything for a viewing session: - **Server → Browser** — encoded binary frames (one per WS message). - MJPEG: raw JPEG bytes per frame. - AVCC: 1-byte tag + payload — `0x01` avcC description, `0x02` keyframe, `0x03` delta, `0x04` JPEG seed (renders before H.264 IDR lands). - **Browser → Server** — text JSON, one line per message: - Stream control: `{"type":"set_bitrate","bps":N}` / `{"type":"set_fps","fps":N}` / `{"type":"set_scale","scale":N}` / `{"type":"force_idr"}` / `{"type":"snapshot"}`. - Gesture input: same wire format as `baguette input` (see below). No `/event` POST, no UDID-keyed registry — the WS handler closure owns the live stream + simulator handle for the duration. ## Device farm ```bash baguette serve open http://localhost:8421/farm ``` A multi-device dashboard for the booted simulators on the host. Every device renders in a single page; the same WebSocket pipeline that powers `/simulators/:udid` drives every tile. **What it does** - **Three view modes** — Grid (compact thumbnails), Wall (large tiles with bezels), and List (one-row-per-device with metadata). Toggle from the header. - **Filter and sort** — by device family, OS version, run state. The rail on the left holds filter state across view changes. - **Click to focus** — clicking any tile re-parents its `

35 Trending Projects