GuidesConnecting to a virtual iOS device with USBFlux

Connecting to a virtual iOS device with USBFlux

The USBFlux app allows you to connect your virtual iOS devices to programs like Xcode using the USB protocol - just like plugging your physical device in with a USB cable.

The USBFlux app allows you to connect your virtual iOS devices to programs like Xcode using the USB protocol - just like plugging your physical device in with a USB cable.

How does USBFlux work?

Under the hood, the usbfluxd daemon redirects the standard usbmuxd socket to allow connections to local and remote usbmuxd instances so remote devices appear connected locally.

Getting Started for MacOS

Head to your Device page and click the USBFlux button to download the USBFlux app. Then, run the installer and drag the USBFlux icon into your Applications folder.

If you are using our cloud product, ensure that you are connected to the VPN. VPN profiles are per Project, so USBFlux will detect all devices within the Project that you are connected to.

Next, launch USBFlux and click "Start." If you are using the on-site version, you will need to enter your domain and credentials. USBFlux will automatically detect the number of "On" devices in your project. "Off" devices are not detected.

Shut down and restart any programs like Xcode or Console where you want to connect your virtual devices. Be sure to fully shut down any running processes and restart the program to pick up the USBFlux changes. You must restart these programs every time you run USBFlux.

Linux and Windows

For Linux, you can download and install USBFlux from github.com/corellium. Currently, USBFlux is not available for Windows.

Notes

Note that latency can significantly impact USBFlux connection speed. Even under normal local speeds, whenever a new device is first connected to Xcode, a large dyld-shared-cache file must be synced, which can take an average of 15-20 minutes. Checking the box for "Connect via network" in Xcode -> Devices and Simulators -> Device View may optimize that speed. To optimize creating device caches for Xcode locally, check out this awesome tool.