iasync/doc/iasync.1.md
2025-01-22 20:27:19 -08:00

2.8 KiB

IASYNC(1) - General Commands Manual

NAME

iasync - sync files to iOS app folders

SYNOPSIS

iasync [options] command [command_options]
iasync lsdevs [command_options]
iasync lsapps [command_options]
iasync ls [command_options]
iasync sync [command_options] source target

DESCRIPTION

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

Global Options

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

-n, --name name

-u, --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.

-v, --verbose

Increases the verbosity. This can be used multiple times. This is mutally exclusive with --quiet.

-q, --quiet

Lowers the verbosity. This is mutually exclusive with --verbose.

Commands

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.

-n, --no-headers

Suppress the table headers.

iasync lsapps [-n | --no-headers]

Lists apps that support file sharing for the connected device.

-n, --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.

-a, --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.

-D, --allow-delete

Allow the sync operation to delete remote files to ensure the remote directory tree matches the local tree.

-n, --dry-run

Explain what would have been done, instead of performing the operations.

-p, --progress

Print progress information for files being copied.

EXIT STATUS

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

SEE ALSO

ifuse(1), idevicepair(1)

BUGS

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:

https://github.com/snowkat/iasync

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

Linux 6.12.7-gentoo-dist - January 22, 2025