Skip to content

pymobiledevice3 lockdown

Pair/Unpair device or access other lockdown services

recovery

enter recovery

pymobiledevice3 lockdown recovery [OPTIONS]

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

service

send-receive raw service messages with a given service name

pymobiledevice3 lockdown service [OPTIONS] {service_name}

Arguments:

Argument Description
service_name [required]

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

developer-service

send-receive raw service messages with a given developer service name

pymobiledevice3 lockdown developer-service [OPTIONS] {service_name}

Arguments:

Argument Description
service_name [required]

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

info

query all lockdown values

pymobiledevice3 lockdown info [OPTIONS]

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

get

query lockdown values by their domain and key names

pymobiledevice3 lockdown get [OPTIONS]

Options:

Option Description
--domain <str>
--key <str>

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

set

set a lockdown value using python's ast.literal_eval()

pymobiledevice3 lockdown set [OPTIONS] {value}

Arguments:

Argument Description
value [required]

Options:

Option Description
--domain <str>
--key <str>

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

remove

remove a domain/key pair

pymobiledevice3 lockdown remove [OPTIONS] {domain} {key}

Arguments:

Argument Description
domain [required]
key [required]

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

unpair

unpair from connected device

pymobiledevice3 lockdown unpair [OPTIONS]

Options:

Option Description
--host-id <str>

Accepts the connection options: --rsd, --tunnel, --userspace, --udid.

pair

pair device

pymobiledevice3 lockdown pair [OPTIONS]

Accepts the connection options: --rsd, --tunnel, --userspace, --udid.

pair-supervised

pair supervised device

pymobiledevice3 lockdown pair-supervised [OPTIONS] {keybag}

Arguments:

Argument Description
keybag [required]

Accepts the connection options: --rsd, --tunnel, --userspace, --udid.

save-pair-record

save pair record to specified location

pymobiledevice3 lockdown save-pair-record [OPTIONS] {output}

Arguments:

Argument Description
output [required]

Accepts the connection options: --rsd, --tunnel, --userspace, --udid.

date

get device date

pymobiledevice3 lockdown date [OPTIONS]

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

heartbeat

start heartbeat service

pymobiledevice3 lockdown heartbeat [OPTIONS]

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

language

Get/Set current language settings

pymobiledevice3 lockdown language [OPTIONS] [language]

Arguments:

Argument Description
language

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

locale

Get/Set current language settings

pymobiledevice3 lockdown locale [OPTIONS] [locale]

Arguments:

Argument Description
locale

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

device-name

get/set current device name

pymobiledevice3 lockdown device-name [OPTIONS]

Options:

Option Description
--new-name <str>

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

wifi-connections

get/set wifi connections state

pymobiledevice3 lockdown wifi-connections [OPTIONS]

Options:

Option Description
--state <on\|off>

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

start-tunnel

start tunnel

pymobiledevice3 lockdown start-tunnel [OPTIONS]

Options:

Option Description
--script-mode / --no-script-mode Show only HOST and port number to allow easy parsing from external shell scripts [default: no-script-mode]

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

remotepairing

Perform a RemotePairing handshake over the com.apple.dt.remotepairingdeviced.lockdown control channel and print the device's handshake info (peer device info, wire protocol versions, pairing capabilities). This control channel does not create tunnels - use start-tunnel for that.

With --pair, performs RemotePairing pair-setup when the device is not already paired. Because this runs over the already-trusted lockdownd (USB) transport, pairing is promptless - no Trust dialog is shown - and it writes the RemotePairing pair record used by pymobiledevice3 remote start-tunnel, letting you bootstrap that record over USB without any on-device interaction.

pymobiledevice3 lockdown remotepairing [OPTIONS]

Options:

Option Description
--pair Perform RemotePairing pair-setup if not already paired (promptless over lockdownd)
--raw Do not decode the base64 deviceKVSData blob

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

assistive-touch

get/set assistive touch icon state (visibility)

pymobiledevice3 lockdown assistive-touch [OPTIONS]

Options:

Option Description
--state <on\|off>

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.