Skip to content

Android app for the Unison file-synchronization tool

License

Notifications You must be signed in to change notification settings

stebeh/unison-android

Repository files navigation

Unison Android App

This app brings the Unison file-synchronization utility to Android. It can run Unison either on demand or as a background process (-repeat watch) that is simple to manage.

Screenshots

           

Usage

The app needs to be provided with a Unison profile; see the sample profile or refer to the Unison manual for advanced options. Note that many options are untested and may cause unexpected behaviour.

If your profile has a remote root, you will need to also select an (OpenSSH) key file in order to establish passwordless ssh connections. This is the private component of the key pair generated by ssh-keygen (and normally resides in ~/.ssh/id_rsa on Linux systems). Please see https://www.ssh.com/ssh/keygen/ for more information.

(Known) limitations and bugs

  • Only non-interactive (-batch) mode is supported.
  • Symlinks on remote host will cause (non-fatal) errors due to the fact that Android's external storage does not support them. It is recommended to manually add such paths to ignore list in profile.
  • Timestamps in status and logs do not respect Android's timezone. (Will probably need to be fixed by modifying binary as opposed to app.)
  • See todo.

Testing

APK binaries, if any, can be found under releases.

Acknowledgements

Unison is written by Benjamin C. Pierce.

Android binaries of the program taken from https://github.com/vovcacik/unison-build-scripts.

Icons provided by https://icons8.com/.

Contribute

Contributions are welcome.

About

Android app for the Unison file-synchronization tool

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages