Skip to content

pymobiledevice3 power-assertion

Hold a power assertion on the device for TIMEOUT seconds (Ctrl+C to stop early).

pymobiledevice3 power-assertion [OPTIONS] {assertion_type}:<AMDPowerAssertionTypeWirelessSync|PreventUserIdleSystemSleep|PreventSystemSleep> {name} {timeout} [details]

Arguments:

Argument Description
assertion_type:<AMDPowerAssertionTypeWirelessSync\|PreventUserIdleSystemSleep\|PreventSystemSleep> Power assertion type to create. [required]
name Name to identify the assertion on the device. [required]
timeout How long to hold the assertion, in seconds. [required]
details Optional description attached to the assertion.

Options:

Option Description
--native macOS only: reach the iOS 17+ tunnel by piggybacking Apple's own remoted tunnel via the remotepairingd service. NO root, no entitlement, no Xcode. Rides Apple's kernel-routable tunnel, so throughput matches the kernel tunnel, but the device keeps a single RSD connection on it: remoted and this process evict each other's, which can reset connections and leave Xcode/devicectl without the device until remoted reconnects. Mutually exclusive with --rsd/--tunnel/--userspace. [env var: PYMOBILEDEVICE3_NATIVE]
--install-completion Install completion for the current shell.
--show-completion Show completion for the current shell, to copy it or customize the installation.

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