Skip to content

mischah/syncthis

GitHub Release CI License: MIT Sponsor

syncthis icon syncthis

Automatic directory synchronization via Git.

Keep your files in sync across devices — no manual Git needed. Primary use case: Obsidian vault synchronization.

Desktop App

syncthis runs as a tray app that sits in your menu bar. Connect your GitHub account, pick a repository, choose a local folder, and your files stay in sync automatically.

syncthis Tray Popover

Features

Visual conflict resolution — When the same file is edited on two devices, resolve conflicts with a side-by-side diff view:

Conflict Resolution Conflict Resolution

Dashboard — Monitor sync health, view activity, and manage settings:

Detail View

Setup wizard — Connect GitHub, pick a repo, choose a folder — done:

Setup Wizard

Prerequisites

  • A GitHub account (free)
  • Git installed (CLI only — the desktop app includes Git)

New to Git? Follow the Obsidian Setup Guide for a step-by-step walkthrough.

Download

Download the latest release from GitHub Releases.

Platform Format
macOS DMG (arm64 + x64)
Linux deb

Command Line

syncthis is also available as a CLI tool:

npm install -g syncthis syncthis init --remote git@github.com:yourname/vault.git syncthis start

See the CLI documentation or the npm page for full details.


How It Works

On a configurable schedule (default: every 5 minutes), syncthis commits local changes, pulls remote changes via rebase, and pushes — fully automatic. Conflicts are detected and resolved based on your chosen strategy. See How It Works for the full sync cycle.


Documentation


Support

If you find syncthis useful, consider supporting its development:


License

MIT

About

Keep files synced across devices — no manual Git needed.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors