mobileboxlab / ios-bash-streaming

iOS screen mirroring in five lines of bash

---

iOS screen mirroring through a socket interface for streaming real time screen capture data out of iOS devices.

Requirements

1. bash, any recent version should work
2. Install imagemagick
3. Install websocketd
4. Install libimobiledevice
5. Lightning cable

Getting started

chmod +x smile.sh

Check all available devices:

instruments -s devices

Run the below command to start the service (you need to provide the device id):

websocketd --port=9231 --staticdir=web sh smile.sh DEVICE-ID

Go to http://127.0.0.1:9231/ You will see the connected device.

Share Your Screen with Others

Optionally you can share your screen with others through Serveo that expose the local server to the internet without installation, no signup and free!

Try it! Copy and paste this into your terminal:

ssh -R 80:localhost:9231 serveo.net

The -R option instructs your SSH client to request port forwarding from the server and proxy requests to the specified host and port (usually localhost). A subdomain of serveo.net will be assigned to forward HTTP traffic.

Frequently Asked Questions

Is this for real?

Yes. It’s not big, and it’s not clever but this is a real iOS screen mirroring in five lines of bash.

How do I install it?

You don't install it.

Does it support websockets?

Yes.

Limitations?

Does not do a high framerate.

Does it work on Windows?

Mmm... maybe.

Contribution

Any ideas are welcome. Feel free to submit any issues or pull requests.

---

ios-bash-streaming is developed and maintained by Mobilebox team.

ios-bash-streaming's Issues

WebSocket connection to 'wss://127.0.0.1:9231/' failed: Error in connection establishment: net::ERR_SSL_PROTOCOL_ERROR

I got this error when trying to mirror my iphone

Not working

I have problem when Getting Started
In console it will print "WebSocket connection to 'wss://127.0.0.1:9231/' failed:"
I try with iPhone 6s, 14.5, MacOSX 11.3
Please help.

Not working. seeing wss secured connection error

Not working.