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
- Right-click the file and select Open > Edit. For an image, a video, or a PDF, select Open > Open in Desktop.
- The file opens in the application your computer uses for it, such as Word, Excel, or a CAD program.
- 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:
- Right-click the folder and select Checkout, or Checkout to… to choose where it goes on your computer.
- Work on the files in that folder.
- 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.