Reference

ideviceinstaller(1)

Manage apps on iOS devices.

NAME

ideviceinstaller - Manage apps on iOS devices.

SYNOPSIS

ideviceinstaller [OPTIONS]

DESCRIPTION

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.

AUTHORS

Nikias Bassen

Martin Szulecki

ON THE WEB

https://libimobiledevice.org

https://github.com/libimobiledevice/ideviceinstaller

History

--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).