Repository navigation
1.0.0
GSync 1.0.0
Two-way sync between your vault and a Google Drive folder using the Google Drive API. Works on desktop, Android, and iPad/iPhone.
Install
- BRAT: Add beta plugin →
dg0988/ObsidianGSync - Manual: download
main.jsandmanifest.jsonbelow into<vault>/.obsidian/plugins/gsync/
Full setup is in the README.
What's new
- Renamed to GSync (plugin ID
gsync), previously "Google Drive Vault Sync" (gdrive-vault-sync). - Sign in with Google on every device. Sign-in now works directly on Android and iOS: your browser opens, you approve, and you're sent back to Obsidian. No more copying refresh tokens between devices (still supported as an option).
- No Node.js or Electron APIs. Sign-in uses only Web APIs and a static redirect page hosted in this repo (
docs/callback.html). - New setting: Sign-in redirect page. Defaults to
https://dg0988.github.io/ObsidianGSync/callback.html; can point to your own copy. - Added LICENSE (MIT), source code, and README disclosures for network use and account requirements.
Features
- Two-way sync with conflict copies: nothing is silently overwritten
- Deletions go to Drive trash / Obsidian trash, and deletion sync can be turned off
- First sync compares contents, so it works with folders that already hold your notes
- Hidden folders (
.obsidian,.trash,.git) are never synced - Exclude rules and a max file size limit
- Progress saved every 10 files; interrupted syncs resume instead of starting over
- Sync from the settings button, the ribbon icon, the command palette, on startup, or on a timer
Upgrading from Google Drive Vault Sync (0.1.x)
- Create a new OAuth client in Google Cloud: type Web application, with authorized redirect URI
https://dg0988.github.io/ObsidianGSync/callback.html. Desktop app clients can't use the new sign-in. - Install GSync. It installs into a new
gsyncfolder, so settings don't carry over. - Sign in and set your Drive folder. Enter the new client ID and secret, tap Sign in with Google, and set the same Drive folder as before. The first sync compares files by content, so nothing is duplicated.
- Uninstall Google Drive Vault Sync and delete
.obsidian/plugins/gdrive-vault-sync/.
Notes
- If a device's vault is already inside Google Drive for Desktop, don't also run GSync there against the same folder.
- Publish your Google OAuth app to In production, or sign-ins expire every 7 days.