VNC server
Remotely control an iOS device using a keyboard and mouse
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 --vncPort
option.
Connecting to the VNC server
To connect to the VNC server, have your VNC client using the following parameters:
Parameter | Value |
---|---|
Server | localhost or 127.0.0.1 |
Port | 5900 or the value specified in --vncPort |
Password | The UDID of your device |
Supported Clients
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.
Hardware Keys
You can use the following special key codes to simulate clicking on hardware buttons:
Device Button | Key Code | Key Description |
---|---|---|
Home Button | 0xffeb |
Super Left |
Power Button (Lock/Unlock) | 0x1008FF10 |
XF86XK_Standby |
Volume Up | 0x1008FF13 |
XF86XK_AudioRaiseVolume |
Volume Down | 0x1008FF11 |
XF86XK_AudioLowerVolume |
For more information about the Quamotion xcuitrunner command-line utility, contact us at info@quamotion.mobi.
Last modified January 21, 2020: Fix image URL (6c0dc42)