obsidian-plugin/oilandrust_obsidian-gdocs
1
0
Fork 0
mirror of https://github.com/oilandrust/obsidian-gdocs.git synced 2026-07-22 07:32:32 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
9 commits 1 branch 7 tags 58 KiB
TypeScript 81.8%
JavaScript 11.7%
CSS 6.5%
Find a file
Olivier Rouiller f78dd5bdb2 Release 1.0.5 with Obsidian review lint fixes. 
Fix settings heading wording, remove unused import, and drop
redundant event type assertion.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-05 13:16:26 +02:00
.github/workflows Prepare plugin for GitHub and community submission. 2026-06-04 18:30:40 +02:00
src Release 1.0.5 with Obsidian review lint fixes. 2026-06-05 13:16:26 +02:00
test Add GDocs Obsidian plugin for Google Drive shortcuts. 2026-06-04 18:24:56 +02:00
.gitignore Add GDocs Obsidian plugin for Google Drive shortcuts. 2026-06-04 18:24:56 +02:00
COMMUNITY_SUBMISSION.md Prepare plugin for GitHub and community submission. 2026-06-04 18:30:40 +02:00
esbuild.config.mjs Add GDocs Obsidian plugin for Google Drive shortcuts. 2026-06-04 18:24:56 +02:00
LICENSE Prepare plugin for GitHub and community submission. 2026-06-04 18:30:40 +02:00
manifest.json Release 1.0.5 with Obsidian review lint fixes. 2026-06-05 13:16:26 +02:00
package-lock.json Add GDocs Obsidian plugin for Google Drive shortcuts. 2026-06-04 18:24:56 +02:00
package.json Release 1.0.5 with Obsidian review lint fixes. 2026-06-05 13:16:26 +02:00
README.md Release 1.0.2 with embedded in-tab Google Docs viewer. 2026-06-05 12:42:17 +02:00
README_DEV.md Release 1.0.2 with embedded in-tab Google Docs viewer. 2026-06-05 12:42:17 +02:00
styles.css Release 1.0.2 with embedded in-tab Google Docs viewer. 2026-06-05 12:42:17 +02:00
tsconfig.json Add GDocs Obsidian plugin for Google Drive shortcuts. 2026-06-04 18:24:56 +02:00
versions.json Release 1.0.5 with Obsidian review lint fixes. 2026-06-05 13:16:26 +02:00

README.md

GDocs

Plugin that opens Google Drive shortcut files in the editor tab. Particularly suited for those who store and sync their vault in Google Drive.

When Google Drive for Desktop (or similar sync) stores Docs, Sheets, and other Workspace files in your vault, they appear as small JSON files (.gdoc, .gsheet, etc.). GDocs registers those extensions, shows them in the file explorer with their extension, and displays the linked Google document in the same tab when you click them.

Repository: https://github.com/oilandrust/obsidian-gdocs

Requirements

  • Obsidian 1.8+ (desktop for embedded browser)
  • Google Drive shortcut files in your vault (from Drive for Desktop, rclone, Synology Drive, etc.)

Supported extensions

Extension Google app
.gdoc Docs
.gsheet Sheets
.gslides Slides
.gdraw Drawings
.gform Forms
.gtable Tables
.gscript Apps Script
.gjam Jamboard

Usage

Click any .gdoc, .gsheet, or other supported shortcut in the file explorer. The plugin reads doc_id, url, or resource_id from the JSON shortcut and shows the document in the current tab.

  • Normal click — opens in the active tab (like switching between notes).
  • Cmd/Ctrl+click or middle-click — opens in a new tab (standard Obsidian behavior).

The document is rendered in an embedded browser inside the file tab. This is separate from the core Web Viewer plugin (no shared toolbar or login session).

Mobile

Embedded browser is not available on mobile. GDocs shows the URL with Copy link and Open in browser buttons.

Shortcut file format

Shortcut files are JSON. Google Drive for Desktop typically uses:

{
  "doc_id": "1VxFROKm0zoJV2iH678wO94hZ0PY9fN_gAGOxhZacc8w",
  "email": "you@example.com"
}

GDocs builds the Docs/Sheets URL from doc_id and the file extension (.gdoc, .gsheet, etc.).

Older or third-party sync tools may use:

{
  "url": "https://docs.google.com/spreadsheets/d/…/edit",
  "resource_id": "spreadsheet:…"
}

Troubleshooting

  • Files not visible in the explorer
    Check Settings → Files & links → Detect all file extensions, and ensure .gdoc / .gsheet are not listed under Excluded files.

  • Warning about moving shortcut files
    Do not move .gdoc / .gsheet files out of a syncing Google Drive folder; Google may delete the online document.

License

MIT