Pair a Device

use idevice::{
    IdeviceService,
    lockdown::LockdownClient,
    usbmuxd::{UsbmuxdAddr, UsbmuxdConnection},
};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Pairing starts over usbmuxd, so first choose the device to trust.
    let addr = UsbmuxdAddr::from_env_var()?;
    let mut usbmuxd = UsbmuxdConnection::new(addr.to_socket().await?, 0);
    let device = usbmuxd
        .get_devices()
        .await?
        .into_iter()
        .next()
        .ok_or("no devices connected")?;

    // Lockdown owns the pair request shown on the device.
    let provider = device.to_provider(addr, "my-pairing-tool");
    let mut lockdown = LockdownClient::connect(&provider).await?;

    // The pairing record is returned to the caller instead of saved automatically.
    let host_id = uuid::Uuid::new_v4().to_string().to_uppercase();
    let buid = usbmuxd.get_buid().await?;
    let mut pairing_file = lockdown.pair(host_id, buid, Some("My App")).await?;

    // Test the record, attach the UDID, then save it through usbmuxd.
    lockdown.start_session(&pairing_file).await?;
    pairing_file.udid = Some(device.udid.clone());

    let bytes = pairing_file.serialize()?;
    usbmuxd.save_pair_record(&device.udid, bytes).await?;

    Ok(())
}

[dependencies]
idevice = { version = "0.1.64", features = ["usbmuxd", "pair"] }
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }
uuid = { version = "1", features = ["v4"] }

idevice-tools pair

idevice-tools pair <device-udid>

idevice-tools pair --name "My Mac" <device-udid>

pair_host

pair_apple_tv