No description
Find a file
ml2310 ef2016edab Fix: vault events during sync cause pulled files to re-appear in pendingOps
writeLocal()/modifyBinary() fires Obsidian vault modify/create events
asynchronously. These events fire AFTER the pendingOps cleanup, so
result.pulled files get re-added to pendingOps on the next tick.

Fix: skip handleModify/handleCreate entirely while this.syncing is true.
Events during sync are caused by the sync itself (writeLocal), not by
real user edits. Real offline edits are caught by mergeOfflineDiff on
next startup.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-14 09:45:47 +08:00
src Fix: vault events during sync cause pulled files to re-appear in pendingOps 2026-04-14 09:45:47 +08:00
.gitignore Initial release of NeoGDSync v0.1.0 2026-04-13 01:44:39 +08:00
esbuild.config.mjs Initial release of NeoGDSync v0.1.0 2026-04-13 01:44:39 +08:00
LICENSE Add MIT LICENSE 2026-04-14 00:09:51 +08:00
main.js Fix: vault events during sync cause pulled files to re-appear in pendingOps 2026-04-14 09:45:47 +08:00
manifest.json Bump version to 0.1.3 2026-04-14 09:30:04 +08:00
README.md Add README 2026-04-13 02:00:24 +08:00
styles.css Initial release of NeoGDSync v0.1.0 2026-04-13 01:44:39 +08:00
tsconfig.json Initial release of NeoGDSync v0.1.0 2026-04-13 01:44:39 +08:00

NeoGDSync

Lightweight Google Drive sync plugin for Obsidian.

Features

  • Smart Sync — auto conflict detection, only syncs changed files
  • Force Push — local vault → Google Drive
  • Force Pull — Google Drive → local vault
  • Conflict handling — saves Drive copy as a conflict file, never overwrites silently
  • Path-based index — fast, no full crawl needed after first sync
  • Version history — optionally keep file revisions on Drive
  • Configurable excludes — glob patterns to skip files/folders
  • URI handlerobsidian://neogdsync?mode=smart|push|pull for automation

Setup

  1. Install the plugin
  2. Go to Settings → NeoGDSync
  3. Enter your Google OAuth2 Refresh Token
  4. Enter your Google Drive Vault Root Folder ID (the Drive folder that maps to your vault root)
  5. Click the ☁ ribbon icon or run a command to sync

Getting a Refresh Token

This plugin uses a standard OAuth2 refresh token with read/write access to Google Drive.

You can obtain one via:

The token is stored locally in your vault's plugin data and never leaves your device except to authenticate with Google.

Commands

Command Description
Smart Sync Detect and sync only changed files, with conflict detection
Force Push Upload all local changes to Drive
Force Pull Download all Drive changes to local
Rebuild Drive Index Re-crawl Drive vault folder to rebuild index
Show Conflicts View detected conflicts

URI Handler

Trigger sync from outside Obsidian (Shortcuts, scripts, etc.):

obsidian://neogdsync?mode=smart
obsidian://neogdsync?mode=push
obsidian://neogdsync?mode=pull

License

MIT