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 handler — obsidian://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 Google Drive for Desktop OAuth flow
• Any OAuth2 tool using scope https://www.googleapis.com/auth/drive

The refresh token is stored locally in your vault's plugin data. To obtain short-lived access tokens, the plugin sends the refresh token to an OAuth proxy (by default the NeoGDSync Cloudflare Worker, see oauth-proxy/worker.js), which exchanges it with Google and returns the access token. The proxy does not store tokens. If you prefer not to route through the shared proxy, deploy your own Worker (instructions in oauth-proxy/worker.js) and set its URL in Settings → NeoGDSync → Auth proxy URL.

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