Skip to content

1.0.0

Choose a tag to compare

@dg0988 dg0988 released this 06 Oct 02:24
· 19 commits to main since this release
52afc1d

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.js and manifest.json below 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)

  1. 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.
  2. Install GSync. It installs into a new gsync folder, so settings don't carry over.
  3. 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.
  4. 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.