IASYNC(1) General Commands Manual IASYNC(1)

iasyncsync files to iOS app folders

iasync [options] command [command_options]

iasync lsdevs [command_options]

iasync lsapps [command_options]

iasync ls [command_options]

iasync sync [command_options] source target

iasync syncs files to Documents folders for iOS apps that support file sharing.

The following options largely affect all commands, and should be provided before the command name.

--name name
 
--udid udid
Connect to the device with the provided name or UDID. This can be discovered with the lsdevs command if the device is already connected.
--verbose
Increases the verbosity. This can be used multiple times. This is mutally exclusive with --quiet.
--quiet
Lowers the verbosity. This is mutually exclusive with --verbose.

iasync lsdevs [-n | --no-headers]
Lists devices connected to the computer as a table. For each connected device, this shows the name, whether it's connected over USB or Network (Wi-Fi), and its UDID.
--no-headers
Suppress the table headers.
iasync lsapps [-n | --no-headers]
Lists apps that support file sharing for the connected device.
--no-headers
Suppress the table headers.
iasync ls [-a | --all] app_id[:path]
Lists all files in the directory provided by the path argument, relative to the root of the app's Documents folder.
--all
Display entries with names starting with a dot (`.').
iasync sync [-Dnp] source app_id[:path]
Copies the files from the source directory to the path provided by the app_id and path arguments.
--allow-delete
Allow the sync operation to delete remote files to ensure the remote directory tree matches the local tree.
--dry-run
Explain what would have been done, instead of performing the operations.
--progress
Print progress information for files being copied.

iasync exits with either 1 or 2 if an error occurred.

ifuse(1), idevicepair(1)

iasync is still heavily in development, and bugs are to be expected. While efforts are made to avoid loss of data, users should ensure their files are backed up before performing a sync if they have any important data that could be lost.

Bugs can be reported on GitHub at:

or by sending an e-mail to snow@datagirl.xyz.

January 22, 2025