Install

The desktop programs have a first release for Windows and Linux; its files are unsigned. The Android app is in Google Play.

The desktop programs are installed from downloaded files. The files of the desktop release, with their checksums, are on the Download page of this site. The Android app is the exception: you install it from Google Play, see the section Android app below. The project's source code is not public, so there is no way to build easysync yourself.

Which program is for what #

• Desktop app for Windows, macOS and Linux (no macOS file in the first release): the normal way to use easysync on a computer. See Desktop installers for the installers, the first start and how to remove the app.
• Android app, below.
• Web app in a browser, with limits: see The web app and its limits.
• Command line and daemon (easysync) for computers without a window system, and relay (easysync-relay) for people who run their own relay: below.
• There is no iOS app yet.

The desktop app can also check for a newer version, but only if you switch that on. What the desktop app contacts says what it sends and to whom.

Check every download #

Every downloadable file has a .sha256 file next to it. Put both in one folder and compare:

• Linux: sha256sum -c <file>.sha256
• macOS: shasum -a 256 -c <file>.sha256
• Windows (PowerShell): Get-FileHash <file>, then compare the value with the one in the .sha256 file

A matching checksum shows that the file arrived intact. The files are not signed yet, so it does not show who made them; Windows SmartScreen and macOS Gatekeeper warn before the first start of an unsigned program.

Command line, daemon and relay #

The Download page of this site lists the files of the desktop app only; the archives of the command line, the daemon and the relay are not listed there. They are named easysync-<version>-<target>.<ext>:

Unpack the archive into a folder of your choice. Every archive holds easysync, the command line that also runs as the background daemon. Only the two Linux archives also hold easysync-relay, the relay server. Linux: tar -xzf <archive>. Windows (PowerShell): Expand-Archive <archive>. There is no archive for macOS in the first release. Then check that the program runs. On Linux:

./easysync --version

Windows (PowerShell):

.\easysync.exe --version

A relay forwards encrypted data between your devices and sees their IP addresses, timing and volume; read What the relay sees before you rely on one, and Relay to run one. Pair your first two devices with First pairing.

Android app #

The app is me.easysync.mobile. It needs Android 10 or newer (API level 29) and a system WebView of Chrome 94 or newer. You get it from Google Play: Get it on Google Play. The link opens the page of the app in Google Play.

The app asks for the camera only while you scan a pairing code, and for notifications if you want them. While the app runs and a device is paired, a foreground service with an ongoing notification helps keep the phone connected with the screen off. Android may stop it (after 6 hours in 24 on Android 15) or suspend the connection; the Stop button in the notification and in Settings ends it. The form for adding a relay preselects the official relay, which the project operates; if you keep it, the app asks the relay for an access key by itself and you enter no token. What the app and that relay handle is in the privacy policy.

Where files end up #

The programs keep their state in a directory of your user account (a state database and the keys, unless the operating system's key store holds them). The locations on the desktop systems are:

On Windows the desktop installer puts the program itself into %LOCALAPPDATA%\Programs\easysync, never into the state directory above; see Desktop installers for upgrading from 0.3.0 or 0.4.0. The state of a device stays on that device. The Android and iOS apps keep it in storage that only the app can read, and the web app keeps it in the browser's private file system for the web app. Reset and recovery explains how to erase the state.