SynckHub Desktop

SynckHub Desktop is the SynckHub app for Windows and macOS. It includes everything in the web app, and adds what needs your computer: editing files in your own applications, working on folders locally, and large uploads.

To install it, see Install the apps.

Edit a file in your own application

  1. Right-click the file and select Open > Edit. For an image, a video, or a PDF, select Open > Open in Desktop.
  2. The file opens in the application your computer uses for it, such as Word, Excel, or a CAD program.
  3. Edit and save as usual. Each save is uploaded as a new revision of the same file.

While you edit, SynckHub locks the file so others can’t change it at the same time. When you close the file, SynckHub Desktop saves any pending changes and releases the lock.

Tip

If a file stays locked after you close it, open Sync in the sidebar, find the file under File checkouts, and select Save to SynckHub.

Work on a folder locally

To work on a whole folder with local tools, check it out:

  1. Right-click the folder and select Checkout, or Checkout to… to choose where it goes on your computer.
  2. Work on the files in that folder.
  3. When you are ready, open Source Control for the checkout, review Changes, enter a message, and select Commit. Your changes are uploaded as one change to the repository.

Only files and folders are checked out. Emails, task lists, and other records filed in the folder stay in SynckHub.

Select Update to bring in changes others made since you checked out. If a local edit conflicts with one of theirs, SynckHub doesn’t overwrite your file; resolve it and select Update again.

When you are done, select Close session….

Upload large folders

Drag a folder, or select New > Upload folders. SynckHub Desktop uploads in the background and can Pause and Resume. You can close the window; the upload continues while SynckHub Desktop is running. If an upload is interrupted, its state is kept: select Resume to continue where it stopped.

Uploads and exports are listed with their history under Sync.

Manage local edits

Sync in the sidebar lists the files you have open for editing under File checkouts. For each one you can:

Action What it does
Save to SynckHub Saves pending changes, releases the lock, and clears the local copy
Save as copy Saves your local version as a new file next to the original, and restores the original
Discard local changes Restores the repository version. Your local bytes are kept for recovery.
Remove from this device… Stops tracking the local edit. The file in SynckHub isn’t deleted, and pending changes aren’t saved.

Command line

SynckHub Desktop includes a command-line tool for scripts and AI agents. See Use the Desktop CLI.