GitHub - EliotAndres/SimStream: SimStream is a library to stream iOS simulators from your Mac to your iPhone (or any web browser) · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
EliotAndres
SimStream
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>43 Commits<br>43 Commits
.claude
.claude
Sources
Sources
browser
browser
skills/stream-simulator
skills/stream-simulator
.gitignore
.gitignore
Package.swift
Package.swift
README.md
README.md
demo.mp4
demo.mp4
idb_touch_events_bridge.py
idb_touch_events_bridge.py
install_idb.sh
install_idb.sh
start.sh
start.sh
View all files
Repository files navigation
About SimStream
Use the iOS Simulator screen on a browser (mobile or not). Low-latency, limited dependencies.
Demo video
No.wifi_compressed.mp4
Dependencies
Swift/Xcode
idb_companion (brew install facebook/fb/idb-companion): send touch events to the simulator
Python package manager (pip or uv) to run the idb Python bridge ()
cloudflared (brew install cloudflared): needed to expose the stream to an agent like Claude. Skip with --no-tunnel if you only want a local URL.
For streaming: Chrome 94+ or Safari 16.4+ (needs VideoDecoder)
Permissions
Grant both to Terminal (System Settings → Privacy & Security):
Screen Recording — required to capture the Simulator window via ScreenCaptureKit.
Accessibility — used to locate the device-screen rect inside the Simulator window so the macOS title bar is cropped out and touches map to the right device coordinates.
When running inside a MacOS VM, you can force-enable those permissions by modifying TCC.db (integrity protection needs to be disabled, it's the case on Tart VMs)
Installation (with agent skill)
npx skills add EliotAndres/SimStream
Installs a /stream-simulator skill into your coding agent. From then on, ask the agent to start SimStream (or paste an error) and it will handle setup, launch, permission prompts, and troubleshooting for you.
Installation (manual)
./install_idb.sh
Installs idb-companion via Homebrew and creates a Python venv for the touch bridge. Uses uv if present, otherwise falls back to python3 -m venv + pip.
Run
./start.sh # default: serves http://localhost:3738 AND a Cloudflare tunnel<br># URL so an agent (Claude, etc.) can open the stream remotely.<br>./start.sh --no-tunnel # local only — skip cloudflared. Use when you're viewing<br># from a browser on the same machine or LAN.
Notes (AI Generated)
The Swift process disables Window → Show Device Bezels on launch (cleaner capture).
A single Swift binary handles capture, H.264 encoding (hardware with software fallback), HTTP, and WebSocket — no separate signaling server.
Touch events are forwarded to idb_companion over a persistent gRPC bridge (idb_touch_events_bridge.py).
Override the port with PORT=xxxx swift run SimulatorStream.
macOS VMs / Tart guests: VideoToolbox often creates an H.264 session but never delivers frames (kVTVideoEncoderNotAvailableNowErr). The encoder falls back to software H.264 after a few failed output callbacks. To skip hardware from the first frame, set SIMULATOR_STREAM_PREFER_SOFTWARE_ENCODER=1 (e.g. SIMULATOR_STREAM_PREFER_SOFTWARE_ENCODER=1 ./start.sh).
About
SimStream is a library to stream iOS simulators from your Mac to your iPhone (or any web browser)
Resources
Readme
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
stars
Watchers
watching
Forks
forks
Report repository
Releases
No releases published
Packages
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
Swift<br>74.6%
HTML<br>17.1%
Shell<br>5.4%
Python<br>2.9%
You can’t perform that action at this time.