xsync

Documentation

Overview

Command xsync is the rsync-style companion to xftp: a one-shot recursive mirror between a local directory tree and a SharePoint document-library folder over Microsoft Graph. Exactly one of the two arguments is a SharePoint URL, and its position sets the direction — `xsync ./reports <url>` mirrors up, `xsync <url> ./reports` mirrors down — the way scp/rsync key off which side carries host:.

Like rsync, xsync transfers only files that are new or changed. The comparison is by modification time: it stamps each uploaded file's SharePoint fileSystemInfo mtime from the local file, and sets the local mtime from fileSystemInfo on download, so unchanged files aren't re-sent. Size is consulted only once the timestamp says something moved, because SharePoint rewrites Office documents on upload and their stored size never matches the source again (see differs in sync.go). --ignore-times forces the transfer of everything when a local edit left the mtime untouched, and --itemize-changes/-i prints why each file is being sent. --delete removes destination items missing from the source (mirroring proper); --dry-run/-n previews the whole plan and changes nothing. Authentication is device-code; the refresh token is cached at ~/.config/excelano/sp-token.json, shared with xql and the other xfiles tools.