idevicepair(1)

📦
version 1.4.0 · 2 versions
, in alpine 3.24, arch rolling, debian trixie, epel 10, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 idevicepair — bestie edition 💖

okay so real talk: this is the idevicepair(1) page from the General Commands Manual (libimobiledevice gang 🫶), and we're about to make host pairings make sense. no cap.

✨ NAME ✨

idevicepair — manage host pairings with devices and usbmuxd.

🎀 SYNOPSIS 🎀

idevicepair [OPTIONS] COMMAND

🦋 DESCRIPTION 🦋

bestie. it's literally the whole vibe: manage host pairings with devices and usbmuxd. that's the job. that's the gig. 💅

👑 OPTIONS 👑

  • -u, --udid UDID — target a specific device by its UDID. yes, exactly that device, no we're not doing the whole lineup.
  • -w, --wireless — do wireless pairing (go read the NOTE first, i'm begging 😭).
  • -n, --network — connect to a network device (again, NOTE. please. go look).
  • -d, --debug — turn on communication debugging. it will yap. you will see everything. 🔥
  • -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. the main character moment. 👑
  • validate — validate if device is paired with this host.
  • unpair — unpair device with this host. it's giving breakup era 💀
  • list — list devices paired with this host.

🌸 NOTE 🌸

Pairing over network (wireless pairing) is only supported by Apple TV devices. periodt. so if you wanna do a wireless pairing, you have to use the -w command line switch. no switch, no pairing, that's the rule 🫶

first things first tho — put the device into pairing mode by opening Settings > Remotes and Devices > Remote App and Devices. ✨

the pairable device will show up 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. 😭 not me having to break the news. iykyk.

💜 AUTHORS 💜

  • Nikias Bassen
  • Martin Szulecki
  • Julien Lavergne

⭐ ON THE WEB ⭐

and that's the whole page, bestie 🥰 it came straight out of the libimobiledevice fam and it lives under the name idevicepair(1) — slay, ate, no crumbs left. 🦋💖

📦 where this page comes from