Obsidian Stats logoObsidian Stats

CloudBrain Sync

by ferrantealberto69
5
4
3
2
1
Score: 50/100
Install Code

Description

Push your Obsidian notes to CloudBrain so they're searchable from WhatsApp, Telegram and the web (BYOB).

Reviews

No reviews yet.

Stats

0
stars
33
downloads
0
forks
8
days
8
days
8
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
3
commits

Latest Version

0.3.2
9 days ago

Changelog

CloudBrain Sync 0.3.2 — clean automated review, attested releases

Type-safety fixes from the community review, test double moved out of src, local lint with eslint-plugin-obsidianmd, releases built and attested by GitHub Actions.

Co-Authored-By: Claude Opus 5.5 [email protected]

See all version on GitHub

README file from

Github

CloudBrain Sync

Push your notes — and, from the folders you choose, PDFs, images and Office files — to CloudBrain, so your vault becomes searchable from WhatsApp, Telegram and the web through a chat that answers with citations to your notes. Your files stay on your device: the plugin sends copies, and CloudBrain never writes back into your vault.

Disclosures

  • Network use. The plugin sends the content of your Markdown notes to the CloudBrain server you configure (default https://cloudbrain.it), over HTTPS. If you turn on documents, it also sends the files of the folders you chose. It sends nothing else and has no telemetry.
  • Account required. You need a CloudBrain account and an API key from its dashboard.
  • Paid service. CloudBrain is a paid service with a free trial.

What it does

  • Notes. A full sync hashes every Markdown note and uploads only what changed. On create / modify / rename / delete it pushes just that note (modify is debounced ~1.5 s). Re-syncing without changes uploads nothing.
  • Documents (off by default). PDF, Word/Excel/PowerPoint and OpenDocument, RTF, HTML, EML/MSG, EPUB, JSON/XML and images (JPG, PNG, TIFF, HEIC…), only from the folders you choose. Text in images and scanned PDFs is read with OCR on the CloudBrain server. The server rejects files that look like credentials (keys, tokens, 2FA codes).
  • Exclusions. Your Obsidian configuration folder is never sent. You can add your own ignore patterns, and the exclusion rules set in the CloudBrain dashboard are applied before anything leaves your device.

Requirements

  • A CloudBrain account (the trial works).
  • An API key: https://cloudbrain.it/app → Sync → “Connetti Obsidian (push diretto)” → Genera chiave. The key is shown once — copy it.

Installation

From the community store

Settings → Community plugins → Browse → search CloudBrain Sync → Install → Enable.

Manual

  1. Download manifest.json and main.js from the latest release.
  2. Put them in <your-vault>/<config-folder>/plugins/cloudbrain-sync/ (the config folder is .obsidian unless you changed it).
  3. Settings → Community plugins → reload → enable CloudBrain Sync.

Configuration

Open Settings → CloudBrain Sync (the interface is in Italian):

Field Value
CloudBrain endpoint https://cloudbrain.it
API key your cbk_… key
Ignora glob patterns to skip, comma separated (defaults cover .trash/, Templates/, code folders)
Includi documenti turn on to send documents
Cartelle the folders documents are read from — also from the folder context menu: Includi documenti in CloudBrain
Anche su mobile documents on phones too (off by default: files up to 25 MB on mobile data)

Then run Sincronizza tutto adesso (button in settings, or the command palette).

Privacy & isolation

Your key only ever accesses your own space on CloudBrain; it can never touch another user's data.

Development

npm ci
npm test          # vitest
npm run build     # main.js

License

MIT © WeblabFactory

Sponsors