README file from
GithubCloudBridge for Obsidian
Sync your Obsidian vault to any cloud — Yandex Disk, Google Drive, VK Cloud, Dropbox, Telegram, MEGA and 15+ more — through your CloudBridge account. One vault, your choice of storage.
Features
- Two-way vault sync — edits made in the cloud (another device, another Obsidian) come back down
- Conflict safety — when both sides changed, the newer wins and the loser is kept as
name.conflict-<timestamp>.md - Cloud attachments — one command uploads a note's images/files to your cloud and rewrites embeds to public CloudBridge links
- Status bar — sync progress and last-sync time at a glance
Installation
From the official directory (recommended):
Settings → Community plugins → Browse → search «CloudBridge» → Install → Enable. Plugin page: community.obsidian.md/plugins/cloudbridge.
Manual:
- Download
main.js,manifest.json,styles.cssfrom the latest release. - Create
<vault>/.obsidian/plugins/cloudbridge/and copy the three files in. - Reload Obsidian → Settings → Community plugins → enable CloudBridge.
Via BRAT (for beta builds):
- Install the BRAT plugin: Settings → Community plugins → Browse → search «Obsidian42 - BRAT» → Install → Enable.
- Open the command palette → BRAT: Add a beta plugin for testing.
- Paste
nw-cd/cloudbridge-obsidian→ Add Plugin. - Enable CloudBridge in Settings → Community plugins.
Setup
- In CloudBridge → Dashboard → API create an API key (
cb_live_…). Requires the API add-on. - Plugin settings → paste the key, hit Fetch clouds, pick the target cloud.
- Run CloudBridge: Sync vault now (command palette or the cloud ribbon icon).
The vault mirrors into <remote folder>/ at the cloud root — Obsidian/ by default. Open the same folder in a second Obsidian instance and the vault syncs between devices.
How it works
- File operations go through the CloudBridge network drive (
/dav/) — the same WebDAV endpoint Finder/Explorer users mount - Connection list and share-links use the REST API (
/api/v1/) - Sync state (per-file mtime/size) lives in plugin
data.json— first sync moves everything, later runs are diffs only - Deletions are not propagated by default (a missing file is re-downloaded, not deleted). Turn on «Propagate deletions» for true mirroring
Settings
| Setting | Default | What it does |
|---|---|---|
| Server | https://cloud-bridge.ru |
CloudBridge instance |
| Remote folder | Obsidian |
Cloud folder the vault mirrors into |
| Sync interval | 15 min |
0 = manual only |
| Sync on save | on | Push a file ~8 s after editing stops |
| Two-way sync | on | Pull remote changes too |
| Propagate deletions | off | Deleting locally deletes remotely (and back) |
| Hidden folders | off | Include .obsidian, .trash, etc. |
Development
npm install
npm run dev # watch-build into main.js
npm run build # typecheck + production bundle
Symlink into a vault for local testing:
ln -s <repo>/obsidian-plugin "<vault>/.obsidian/plugins/cloudbridge"
# reload Obsidian → Community plugins → enable CloudBridge
CloudBridge — синхронизация хранилища с любым облаком
Синхронизируйте хранилище Obsidian с любым облаком — Яндекс Диск, Google Drive, VK Облако, Dropbox, Telegram, MEGA и ещё 13+ хранилищами — через ваш аккаунт CloudBridge. Одно хранилище — облако на ваш выбор.
Возможности
- Двусторонняя синхронизация — правки, сделанные в облаке (на другом устройстве или в другом Obsidian), возвращаются в хранилище
- Защита от конфликтов — если файл изменён с двух сторон, побеждает
свежая версия, а вторая сохраняется как
имя.conflict-<время>.md - Облачные вложения — одна команда заливает картинки заметки в облако и заменяет вставки на публичные ссылки CloudBridge
- Статус-бар — прогресс синхронизации и время последней проверки
Установка
Из официального каталога: Settings → Community plugins → Browse → поиск «CloudBridge» → Install → Enable. Страница плагина: community.obsidian.md/plugins/cloudbridge.
Настройка
- В CloudBridge → Кабинет → API создайте ключ
cb_live_…(нужна опция API-доступа). - В настройках плагина вставьте ключ, нажмите Fetch clouds, выберите облако.
- Запустите CloudBridge: Sync vault now из палитры команд или иконкой облака на панели.
Хранилище зеркалируется в папку Obsidian/ в корне облака. Откройте
ту же папку во втором Obsidian — и синхронизация заработает между
устройствами.