Caution
Disclaimer: This is a personal project, built primarily for my own use. I share it in the spirit of open source software, but I am not responsible for any lost data. Please review the Security Policy before use. LLM tools were involved in creating this project.
Automatic directory synchronization via Git.
Keep your files in sync across devices — no manual Git needed. Primary use case: Obsidian vault synchronization.
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.
Visual conflict resolution — When the same file is edited on two devices, resolve conflicts with a side-by-side diff view:
Dashboard — Monitor sync health, view activity, and manage settings:
Setup wizard — Connect GitHub, pick a repo, choose a folder — done:
New to Git? Follow the Obsidian Setup Guide for a step-by-step walkthrough.
Download the latest release from GitHub Releases.
| Platform | Format |
|---|---|
| macOS | DMG (arm64 + x64) |
| Linux | deb |
syncthis is also available as a CLI tool:
npm install -g syncthis
syncthis init --remote git@github.com:yourname/vault.git
syncthis startSee the CLI documentation or the npm page for full details.
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.
- Obsidian Setup Guide — Step-by-step for new users
- CLI Reference — All commands and flags
- Conflict Strategies — How conflicts are handled
- How It Works — Sync cycle and service lifecycle
- Development — Dev setup and project structure
If you find syncthis useful, consider supporting its development: