testingbot / ios-vnc

iOS VNC server - Use VNC to connect to your iOS device.

[DEPRECATED] iOS VNC Server

We are no longer maintaining this repository.

This project provides a VNC endpoint which streams the device's screen to your VNC client. Any keyboard and mouse events your VNC client sends will be sent to the iOS device. This does not require the device to be jailbroken.

Setup

• Clone this repository

• Install dependencies:

  • brew install libimobiledevice
  • brew install libpng
  • brew install libvncserver
  • brew install carthage

• Now you can build the project:

  • cd iOSVNCServer && make build

Dependencies

To control the device, you will need to set up WebdriverAgent This project exposes a couple of endpoints to take control of the device. Once you've set this up correctly (signing and ./Scripts/bootstrap.sh), you can run the WebDriverAgent project to expose the endpoint.

Getting Started

The WebDriverAgent project will output a response ServerURLHere->http://[SOME_IP]:8100<-ServerURLHere These values are required and need to be passed to our iosvncserver, together with the udid of the device:

• To get the udid: idevice_id -l
• Start a WebDriverAgent session: curl -X POST -H "Content-Type: application/json" \ -d "{\"desiredCapabilities\":{\"bundleId\":\"com.apple.preferences\"}}" \ [SOME_IP]:8100/session
• Copy the sessionID from this response and pass it to our VNC server:

You can now run the VNC server: ./iosvncserver -u [udid] -H [SOME-IP] -P 8100 -S [session-id]

Point your favorite VNC client to localhost:5901 and you will be able to take control of the real iOS device.

Resources

TestingBot

ios-vnc's Issues

Errors building

I experienced the same build issue as @fruitofgeorge, and successfully solved the imobiledevice error. I then had this error:

ld: library not found for -ljsmn

Aside from "-ljsmn" being confusing (looks like an incorrect parsing of "-l jsmn"), I thought maybe the Makefile including jsmn in the libs was inaccurate. I removed this reference, and then Make worked without error. I'm not certain if this is correct, though.

Will iosVNCServer still work like this?
Thanks

QUOTE <
Digging further, turns out there is supposed to be a makefile in the /jsmn directory but when cloning it just makes an empty folder. I was able to find another repo for jsmn and copy it in.
After taking care of that, it complained of not finding the library for imobiledevice. Looks like when installed with brew, it appends the version number on it. I had to edit the makefile to be -l imobiledevice-1.0 and then it builds.

Originally posted by @fruitofgeorge in #1 (comment)

make build fails

Following the instructions, after entering cd iOSVNCServer && make build I get:

cd ./vendor/jsmn/; make
make[1]: *** No targets specified and no makefile found.  Stop.
make: *** [dependencies] Error 2

It seems like it's looking for another makefile in the /jsmn directory rather than using the one originally called?