---
name: "idevicepair"
section: "1"
platform: "linux"
package: "libimobiledevice"
version: "1.4.0-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/idevicepair"
---

# idevicepair(1)

Manage host pairings with devices and usbmuxd.

## NAME

idevicepair - Manage host pairings with devices and usbmuxd.

## SYNOPSIS

**idevicepair** \[OPTIONS\] COMMAND

## DESCRIPTION

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.

## AUTHORS

Nikias Bassen

Martin Szulecki

Julien Lavergne

## ON THE WEB

https://libimobiledevice.org

https://github.com/libimobiledevice/libimobiledevice