ideviceinstaller(1)

Usage

ideviceinstaller [OPTIONS]

Overview

Allows to enumerate, install, upgrade, and uninstall apps on iOS devices.

Commands

list

List installed apps on the device. Options:

--user: List user apps only (apps installed by the user). This is the default.

--system: List system apps only (apps available from the system firmware).

--all: List all types of apps.

--xml: Print output as XML Property List.

-a, --attribute ATTR

Specify attribute to return. This argument can be passed multiple times. If omitted and --xml is *not* specified, the default attributes CFBundleIdentifier, CFBundleShortVersionString, and CFBundleDisplayName will be used. The attributes can be found in the app's Info.plist, but also some extra attributes exist. Some examples:

StaticDiskUsage disk usage of installed app

DynamicDiskUsage app user data disk usage

Path app installation location

SignerIdentity code signing identity

NOTE: It is suggested to always add CFBundleIdentifier to allow unique identification of the apps.

-b, --bundle-identifier BUNDLEID: Only query given bundle identifier. This argument can be passed multiple times.

install PATH

Install app from a package file specified by PATH. PATH can also be a .ipcc file for carrier bundle installation or a .app directory for developer app installation.

-s, --sinf PATH: Pass an external SINF file located at PATH.

-m, --metadata PATH: Pass an external iTunesMetadata file located at PATH.

uninstall BUNDLEID: Uninstall app specified by BUNDLEID.

upgrade PATH: Upgrade app from a package file specified by PATH.

Legacy commands

The following commands are non-functional with iOS 7 or later.

archive BUNDLEID

Archive app specified by BUNDLEID. Options:

--uninstall: Uninstall the package after making an archive

--app_only: Archive application data only

--docs_only: Archive documents (user data) only

--copy=PATH: Copy the app archive to directory PATH when done

--remove: Only valid when copy=PATH is used: remove after copy

restore BUNDLEID: Restore archived app specified by BUNDLEID.

list-archives

List archived apps on the device. Options:

--xml: Print output as XML Property List.

remove-archive BUNDLEID: Remove app archive specified by BUNDLEID.

Options

-u, --udid UDID: Target specific device by UDID.

-n, --network: Connect to network device.

-w, --notify-wait: Wait for app installed/uninstalled notification before reporting success of operation.

-h, --help: Print usage information.

-d, --debug: Enable communication debugging.

-v, --version: Print version information.

On the web

https://libimobiledevice.org

https://github.com/libimobiledevice/ideviceinstaller

Releases

7 releases since Debian 7 (Wheezy); the text changed 2 times.

--all since Debian 13 (Trixie); --attribute since Debian 13 (Trixie); --bundle-identifier since Debian 13 (Trixie); --metadata since Debian 13 (Trixie); --network since Debian 13 (Trixie); --notify-wait since Debian 13 (Trixie); --sinf since Debian 13 (Trixie); --system since Debian 13 (Trixie); --udid since Debian 11 (Bullseye); --user since Debian 13 (Trixie); --version since Debian 13 (Trixie); --xml since Debian 13 (Trixie); -b since Debian 13 (Trixie); -m since Debian 13 (Trixie); -n since Debian 13 (Trixie); -s since Debian 13 (Trixie); -v since Debian 13 (Trixie); -w since Debian 13 (Trixie).

--archive until Debian 12 (Bookworm); --install until Debian 12 (Bookworm); --list-apps until Debian 12 (Bookworm); --list-archives until Debian 12 (Bookworm); --remove-archive until Debian 12 (Bookworm); --restore until Debian 12 (Bookworm); --uninstall until Debian 12 (Bookworm); --upgrade until Debian 12 (Bookworm); --uuid until Debian 10 (Buster); -L until Debian 12 (Bookworm); -R until Debian 12 (Bookworm); -U until Debian 12 (Bookworm); -g until Debian 12 (Bookworm); -i until Debian 12 (Bookworm); -l until Debian 12 (Bookworm); -o until Debian 12 (Bookworm); -r until Debian 12 (Bookworm).