Skip to content
tddworksPublic

About

Headless control for iOS simulators, real iPhones and Android emulators — 3D models, taps, swipes, multi-finger gestures, 60 fps streaming, and a multi-device farm

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2.3k stars

Watchers

8 watching

Forks

Latest commit

 

History

998 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Baguette

Baguette

Bon appétit.

Drive iOS simulators, real iPhones and Android emulators from one CLI and one browser page.

CI Coverage Latest release License Swift 6.4 macOS 15+ Xcode 26

A single Swift CLI — baguette — plus a self-contained web UI that drives your devices headless, without opening Xcode, Simulator.app or Android Studio: one --udid, the same commands and page for every device, and one that can't do something says so by name and exits 1.

  • iOS simulators — everything below: boot them, stream their screens at 60 fps, dispatch taps, swipes, multi-finger and system gestures, keyboard and hardware buttons, read the accessibility tree, tail the unified log, take screenshots and recordings, and feed them a camera, a location, motion and a slower network — on iOS 26 and later, where the 5-argument HID call idb and AXe rely on stopped working.
  • Real iPhones on a cable — touches, a live screen, screenshots, recordings, the pasteboard and the accessibility tree, through CoreDevice → real devices.
  • Android emulators — boot and shut down an AVD, stream its screen, touches with two fingers, scrolls, buttons (back too), keys and typing, through the emulator's own control API → Android.

Demo

demo.mp4
device-farm-demo.mp4
Recording.at.2026-05-04.13.20.02.2.mov

Install

brew install baguette

Apple Silicon with Xcode 26 — baguette links the private SimulatorKit / CoreSimulator frameworks that ship with Xcode. If Homebrew complains about Rosetta, see Troubleshooting.

  • A real iPhone needs to be paired with Xcode, in Developer Mode, on the cable, unlocked, with its developer disk image mounted.
  • Android emulators need the Android SDK's adb and emulator: $ANDROID_HOME, $ANDROID_SDK_ROOT or Android Studio's ~/Library/Android/sdk.

Run from source

git clone https://github.com/tddworks/baguette && cd baguette
swift run Baguette serve                # Swift 6.4; builds, then serves http://127.0.0.1:8421
swift run Baguette list                 # any command runs the same way

The rest of development is in CONTRIBUTING.

Quick start

baguette serve                          # web UI at http://127.0.0.1:8421/simulators
open http://localhost:8421/farm         # every booted simulator side by side

baguette list                           # simulators, iPhones on a cable, Android emulators
baguette boot --udid <UDID>
baguette tap  --udid <UDID> --x 219 --y 478 --width 438 --height 954
baguette describe-ui --udid <UDID>      # what's on screen, frames in device points

# the same commands on other devices: an iPhone's UDID, an emulator's AVD name
baguette screenshot --udid 00008160-… --output phone.jpg
baguette boot       --udid Pixel_9      # starts the AVD headless
baguette tap        --udid Pixel_9 --x 206 --y 458 --width 412 --height 915

# an App Store-sized screenshot, and a 10-second clip at the same size
baguette screenshot --udid <UDID> --size appstore-6.9 --output hero.png
baguette record     --udid <UDID> --size appstore-6.9 --duration 10 --output demo.mp4

Coordinates are device points (dp on Android), and --width / --height are the screen size in those points (baguette chrome layout --udid <UDID> tells you for a simulator). For a long-lived session, pipe JSON gestures into baguette input — see the wire protocol.

Sponsors

Apps that use and support Baguette development:

AirBuild
AirBuild
Your idea. Your AI team. A working native iOS app. Build the app. AirBuild handles App Review. Specialized agents submit, respond, fix, and resubmit—automatically.

What it covers

Rows below are for simulators; other devices do the parts their pages list.

Area What you can do
Devices iOS simulators, real iPhones on a cable, Android emulators; all in one list and one page → real devices, Android, serve
Touches & gestures Tap, swipe, pinch, pan, streamed one- and two-finger touches, home-indicator and pull-down system gestures → touches, double-tap
Buttons & keyboard Home, lock, volume, action, Watch crown; keystrokes, typed text, paste and clipboard sync → buttons, keyboard, paste
Screen capture Screenshots, recordings, frame streams to stdout, one output-size vocabulary, 3D device renders → screenshot, stream, recording, capture-size, 3d-rendering
Accessibility The on-screen AX tree as JSON, hit-testing, a hover inspector in the browser → accessibility, ax-inspector, ax-hit-test-sweep
Logs Live unified log, filtered by level, predicate or bundle id → logs
Web UI Focus-mode page with bezel, a multi-device farm, a JS SDK for your own page → device-farm, chrome-bezel, baguette-sdk, serve routes
Device lifecycle Boot, shut down, repair input after Xcode 27's Device Hub → boot, device-hub
Device settings Orientation, appearance, contrast, text size, status bar, shake → orientation, interface, status-bar, shake
Simulated world Mac webcam or a file as the camera, GPS and routes, CoreMotion, network conditioning → camera, location, motion, network
Apps & files Deep links and URL schemes, drag-and-drop app install and Photos → deep-links, file-upload
Other screens CarPlay and paired Watch, iPhone Duo and its hinge, a cable-free iPhone mirrored over Wi-Fi (preview) → companion-screens, iphone-duo, hinge, device-twin
Plugins Add panels and commands from a trusted bakery; they run as subprocesses → plugins

More

Docs index · Commands · Wire protocol · Serve routes · Architecture · Contributing · Changelog

License

Apache License 2.0 — see LICENSE.

About

Headless control for iOS simulators, real iPhones and Android emulators — 3D models, taps, swipes, multi-finger gestures, 60 fps streaming, and a multi-device farm

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2.3k stars

Watchers

8 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages