whatisgithub

What is easy-sync?

jiaoyingxing/easy-sync — explained in plain English

Analysis updated 2026-05-18

15TypeScriptAudience · generalComplexity · 2/5Setup · easy

In one sentence

A two way OneDrive sync plugin for the Obsidian note taking app, with automatic conflict merging, mobile support, and no third party server involved.

Mindmap

mindmap
  root((EasySync))
    What it does
      Two way OneDrive sync
      Conflict merging
      Mobile support
    Tech stack
      TypeScript
      Obsidian API
      Microsoft Graph
    Use cases
      Sync notes across devices
      Merge non overlapping edits
      Diagnose sync issues
    Audience
      Obsidian users
    Setup
      Install plugin
      Sign into OneDrive

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Keep an Obsidian vault of notes and attachments synced across a desktop, phone, and tablet using your own OneDrive.

USE CASE 2

Automatically merge non-overlapping text edits made to the same note on two different devices.

USE CASE 3

Review a diagnostic report when a sync issue comes up, to help troubleshoot without exposing private vault contents.

What is it built with?

TypeScriptObsidian APIMicrosoft Graph

How does it compare?

jiaoyingxing/easy-syncaestheticsuraj234/chai-gpt-buildalexvilelabah/age-of-ai
Stars151515
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasymoderate
Complexity2/52/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Needs Obsidian 1.11.4 or newer and a Microsoft OneDrive account to sign into.

Source available license: the code can be viewed and studied, but this is not a standard open source license, so check the LICENSE file for what you're allowed to do with it.

So what is it?

EasySync is a plugin for Obsidian, the note taking app, that lets you sync your notes and attachments across computers, phones, and tablets using your own personal OneDrive account. By default it only moves notes and attachment files, but you can turn on syncing for Obsidian's own settings, themes, and installed plugins if you want those to match across your devices too. It works on Windows, macOS, Linux, iOS, and Android. To get set up, you install the plugin from inside Obsidian's community plugin browser, or manually by placing its files into your vault's plugin folder, then sign in with your Microsoft account through a browser window that opens from within Obsidian. The plugin identifies which cloud sync space to use based on the name of your vault, so you need to give the vault the exact same name on every device you want synced together. The README recommends keeping a single Obsidian vault only under EasySync's management, since running another sync tool like OneDrive's own folder sync, iCloud Drive, Dropbox, or Syncthing on the same vault at the same time can create duplicate files, conflicting deletions, or other mixed up results. When it comes to conflicts, EasySync remembers the last version of a file that both sides agreed on, then compares what each side changed since then. It can automatically combine two sets of edits if they landed in different parts of the same file, and it treats a file as safe to auto resolve if only one side changed it or both sides ended up identical. Anything riskier, like both sides editing the same line, or a binary file such as an image or PDF changing on both ends, is left for you to decide by hand, shown with a side by side comparison. Large files are uploaded in chunks, and before EasySync overwrites a local file with a downloaded version, it keeps a backup copy first. All synced files live inside your own OneDrive account, in a folder the plugin controls directly, with no third party server involved. The plugin does not collect usage data or show ads. It is distributed under a source available license, meaning the code can be read and studied but is not covered by a standard open source license.

Copy-paste prompts

Prompt 1
Explain how EasySync decides which changes to merge automatically versus which ones need my manual decision.
Prompt 2
Walk me through installing this plugin and signing into OneDrive for the first time.
Prompt 3
Explain why I should not run another sync tool like Dropbox on the same vault as EasySync.
Prompt 4
Show me what OneDrive permissions this plugin requests and why.

Frequently asked questions

What is easy-sync?

A two way OneDrive sync plugin for the Obsidian note taking app, with automatic conflict merging, mobile support, and no third party server involved.

What language is easy-sync written in?

Mainly TypeScript. The stack also includes TypeScript, Obsidian API, Microsoft Graph.

What license does easy-sync use?

Source available license: the code can be viewed and studied, but this is not a standard open source license, so check the LICENSE file for what you're allowed to do with it.

How hard is easy-sync to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is easy-sync for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.