idevicepair(1)

Usage

idevicepair [OPTIONS] COMMAND

Overview

Manage host pairings with devices and usbmuxd.

Options

-u, --udid UDID: target specific device by UDID.

-w, --wireless: perform wireless pairing (see NOTE).

-n, --network: connect to network device (see NOTE).

-d, --debug: enable communication debugging.

-h, --help: prints usage information.

-v, --version: prints version information.

Commands

`systembuid`	print the system buid of the usbmuxd host.
`hostid`	print the host id for target device.
`pair`	pair device with this host.
`validate`	validate if device is paired with this host.
`unpair`	unpair device with this host.
`list`	list devices paired with this host.

Note

Pairing over network (wireless pairing) is only supported by Apple TV devices. To perform a wireless pairing, you need to use the -w command line switch.

Make sure to put the device into pairing mode first by opening Settings > Remotes and Devices > Remote App and Devices.

The pairable device will become visible with a special UDID, and then you can run idevicepair like this:

idevicepair -u fffc8:ab:cd:12:34:56fff -w pair

idevicepair will then ask for the PIN that the device is displaying and continues with the pairing once entered.

Please note that wireless pairing is currently not supported on Linux.

On the web

https://libimobiledevice.org

https://github.com/libimobiledevice/libimobiledevice

Releases

9 releases since Debian 6.0 (Squeeze); the text changed 5 times.

--network since Debian 13 (Trixie); --udid since Debian 8 (Jessie); --version since Debian 11 (Bullseye); --wireless since Debian 13 (Trixie); -n since Debian 13 (Trixie); -v since Debian 11 (Bullseye); -w since Debian 13 (Trixie).

--uuid until Debian 7 (Wheezy).