Documentation / Get started

Send a file

You send a file to a paired device. By default the receiving device asks before it accepts, and nothing is written to its disk before then.

Send #

On the sending device:

easysync send <file> <peer>

<file> is a regular file; folders cannot be sent in this version. <peer> is the name of the other device, an alias, or the start of its peer id. Add --wait to keep the command running until the transfer has finished.

easysync send <file> <peer> --wait

If the other device is not connected, the offer waits and is made again when it connects.

Accept #

On the receiving device, list the offers that wait for you and accept one:

easysync transfer list
easysync transfer accept <id>

<id> is the start of the transfer id, at least eight characters. The file is saved in the incoming folder of the device, incoming in its state directory, unless you set another folder with easysync config set incoming_dir <path> or choose one for a single file:

easysync transfer accept <id> --to <folder>

To refuse an offer, use easysync transfer reject <id>. The sender is told, and the offer is not made again.

Let a trusted device send without asking #

If you trust a device and do not want to be asked each time, change its policy on the receiving device:

easysync peer policy <peer> --accept auto

Within the limits of the policy, offers from that device are then accepted at once. The options --max-file-size and --max-incomplete keep the limits. The other values of --accept are ask and deny.

If the connection drops #

You do not have to start again. When the devices connect again, also through a relay or after a restart of either device, the transfer continues from the last part that the receiver has safely stored. A relay only forwards the encrypted data; What the relay sees lists what it can observe. See Transfers and resume.