Obsidian Stats logoObsidian Stats

Spectacles Sync

by Max
5
4
3
2
1
New Plugin
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Sync your vault to Spectacles AR glasses to explore your notes as a 3D knowledge graph.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
0
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

Spectacles Sync

Export your Obsidian vault as a JSON knowledge graph and sync it to a Spectacles AR Lens, where you can explore your notes as a 3D graph. Your vault is end-to-end encrypted with a password you choose — the backend only ever stores an unreadable blob.

How it works

  1. Open Settings → Spectacles Sync and choose a password.
  2. Run Sync vault to Spectacles from the command palette (or click the glasses ribbon icon). The plugin encrypts your vault locally and uploads the ciphertext.
  3. On the Spectacles Lens, enter the same password to decrypt and view your graph. The password is the only pairing secret — there is no separate code.
  4. Re-sync any time. Enable Auto-sync on save to re-upload about 30 seconds after you stop editing.

Privacy & network use

This plugin sends data over the network. Exactly what happens:

  • Where: your vault is uploaded to a backend server (default https://spectacles-sync-backend-production.up.railway.app, configurable under Settings → Advanced → Backend URL). You can self-host the backend and point the plugin at your own URL.
  • What: a single end-to-end encrypted blob. Before anything leaves your device it is encrypted with a key derived from your password (NaCl secretbox / XSalsa20-Poly1305). The server stores only the ciphertext plus a password-derived identifier — it cannot read your notes, and neither can anyone with access to the server.
  • Plaintext contents (inside the encrypted blob): note titles, paths, a 280-character excerpt per note, tags, links, frontmatter, headings, word counts, and timestamps. Full note bodies are included only if you enable Sync full note body (off by default).
  • What is never sent: your password. It never leaves your device.
  • Excluding notes: use Excluded folders and Excluded tags in settings to keep notes out of every sync.

Deleting your data

Run Delete remote Spectacles data from the command palette, or click Delete remote data under Settings → Danger zone. This permanently removes your uploaded blob from the backend.

Because encryption is keyed to your password, the password cannot be recovered if lost — pick one you'll remember.

Development

npm install
npm run dev      # esbuild watch, rebuilds main.js in place
npm run build    # type-check + production build

Symlink this folder into a test vault's .obsidian/plugins/spectacles-sync/, then enable the plugin under Settings → Community plugins.

License

MIT

Sponsors