xcuitrunner contains an embedded VNC server which allows you to remotely control iOS devices using a keyboard and mouse.
Enabling the VNC server
You must specify the
--vnc option if you want to start xcuitrunner with the embedded VNC server.
xcuitrunner will listen for VNC connections at port
5900. You can have xcuitrunner listen on another
port by specifying the
Connecting to the VNC server
To connect to the VNC server, have your VNC client using the following parameters:
|Password||The UDID of your device|
We’ve validated xcuitrunner with the following VNC clients:
- TightVNC Viewer, a desktop-based VNC client for Windows
- UltraVNC, a desktop-based VNC client for Windows and macOS
- noVNC, a HTML5 VNC client. Requires websockify.
- Guacamole, a clientless remote desktop gateway.
You can use the following special key codes to simulate clicking on hardware buttons:
|Device Button||Key Code||Key Description|
|Power Button (Lock/Unlock)||
For more information about the Quamotion xcuitrunner command-line utility, contact us at firstname.lastname@example.org.