Skip to content

pymobiledevice3 apps

List, query, install, uninstall, and inspect apps on the device.

list

List installed apps.

pymobiledevice3 apps list [OPTIONS]

Options:

Option Description
-t, --type <System\|User\|Hidden\|Any> Filter by application type (System/User/Hidden/Any). [default: Any]
--calculate-sizes / --no-calculate-sizes Include app size information (slower). [default: no-calculate-sizes]
--show-placeholders / --no-show-placeholders Include placeholder apps in the results. [default: no-show-placeholders]

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

query

Return metadata for specific bundle identifiers.

pymobiledevice3 apps query [OPTIONS] {bundle_identifiers}...

Arguments:

Argument Description
bundle_identifiers... [required]

Options:

Option Description
--calculate-sizes / --no-calculate-sizes Include app size information (slower). [default: no-calculate-sizes]

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

uninstall

Uninstall an app by bundle identifier.

pymobiledevice3 apps uninstall [OPTIONS] {bundle_id}

Arguments:

Argument Description
bundle_id [required]

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

install

Install a local .ipa/.app/.ipcc package.

pymobiledevice3 apps install [OPTIONS] {package}

Arguments:

Argument Description
package [required]

Options:

Option Description
--developer / --no-developer Install developer package [default: no-developer]

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

afc

Open an AFC shell into the app container; pass --documents for Documents-only.

pymobiledevice3 apps afc [OPTIONS] {bundle_id}

Arguments:

Argument Description
bundle_id [required]

Options:

Option Description
--documents / --no-documents [default: no-documents]

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

webdav

Serve an app container over WebDAV for local mounting; pass --documents for Documents-only.

pymobiledevice3 apps webdav [OPTIONS] {bundle_id} [path]

Arguments:

Argument Description
bundle_id [required]
path AFC path to serve as the volume root (default: /) [default: /]

Options:

Option Description
--documents / --no-documents [default: no-documents]
--mount mount the served path locally and reveal it in your file manager
--host <str> local interface to bind [default: 127.0.0.1]
--bind-port <int> local TCP port (0 picks a free port) [default: 0]
--readonly expose the path read-only

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

pull

Pull a file from an app container to a local path.

pymobiledevice3 apps pull [OPTIONS] {bundle_id} {remote_file} {local_file}

Arguments:

Argument Description
bundle_id [required]
remote_file [required]
local_file [required]

Options:

Option Description
--documents / --no-documents [default: no-documents]

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

push

Push a local file into an app container.

pymobiledevice3 apps push [OPTIONS] {bundle_id} {local_file} {remote_file}

Arguments:

Argument Description
bundle_id [required]
local_file [required]
remote_file [required]

Options:

Option Description
--documents / --no-documents [default: no-documents]

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

rm

Delete a file from an app container.

pymobiledevice3 apps rm [OPTIONS] {bundle_id} {remote_file}

Arguments:

Argument Description
bundle_id [required]
remote_file [required]

Options:

Option Description
--documents / --no-documents [default: no-documents]

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

install-record

Query an app's LaunchServices install record via installcoordination_proxy.

pymobiledevice3 apps install-record [OPTIONS] {bundle_id}

Arguments:

Argument Description
bundle_id [required]

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