/saf_sync

rsync-like file synchronization for Android using the Storage Access Framework

Primary LanguagePythonMIT LicenseMIT

saf-sync

This tiny Python script uses the Termux API to mirror one directory to another using the Android Storage Access Framework (SAF).

This allows a non-root user to copy files from internal storage to external or vice versa, a la rsync. Any files/dirs present in the destination but not the source are deleted. Any files/dirs in the source have their exact contents mirrored to the destination.

The script is very primitive and will overwrite destination files unless lengths exactly match and modification times say the destination is at least as new, so it is not intended for use with large files. The Termux API can't write to a byte range within a file, so the whole file must be overwritten.

THIS WILL NOT BE VERY FAST. Again, it's not intended for large files and will happily run you out of RAM if you try.

Setup

  1. Install Termux and the Termux API app. As of this writing, this script requires the latest Github builds - NOT the latest released version. Perhaps support for the SAF commands will be released soon.
  2. Run pkg install termux-api within Termux (NB: in addition to installing the Termux-API APK above...)
  3. Run termux-saf-managedir for the source directory
  4. Run termux-saf-managedir a second time, for the destination directory
  5. Run termux-saf-dirs. Verify both source and destination are shown. Copy their URIs.
  6. Run python saf_sync.py <SOURCE> <DESTINATION>. Make sure to get the order of the arguments correct.
  7. Profit