Thoth

Thoth

Lightweight vault sync for Obsidian via S3-compatible object storage (Cloudflare R2, AWS S3, MinIO, etc).

Features

• Three-way sync — detects offline deletions, modifications, and conflicts using local sync history
• Parallel transfers — 20 concurrent uploads/downloads for fast initial sync
• Mobile support — works on iOS and Android via Obsidian mobile
• Conflict handling — both versions kept, remote copy saved as .conflict-{device}.md
• Fast startup — caches file hashes, only rehashes files that changed since last sync
• Modular storage backend — S3 interface, easy to add new backends

Setup

1. Create an S3-compatible bucket (e.g., Cloudflare R2)
2. Install Thoth in Obsidian
3. Settings → Thoth Sync → enter endpoint, access key, secret key, bucket name
4. Hit "Test" to verify connection
5. Sync starts automatically

How it works

On each sync, Thoth compares three states:

• Local — current vault files
• Remote — manifest stored in the bucket
• History — snapshot from last successful sync

This three-way comparison determines the correct action for each file (push, pull, delete, or flag conflict) without requiring real-time coordination between devices.

Commands

• Thoth: Push changes now — force push pending changes
• Thoth: Pull changes now — force pull from remote

Both are also available as ribbon icons.

Transferring settings between devices

In Settings → Thoth Sync:

• Show QR — displays a QR code with your connection settings. Scan on your phone to get the encoded string.
• Copy — copies the encoded settings string to clipboard for manual transfer (e.g., via messaging app).
• Import — on the receiving device, paste the settings string to auto-fill endpoint, keys, bucket, and region.

Device ID is not transferred — each device generates its own unique ID.

Supported backends

• Cloudflare R2
• AWS S3
• Any S3-compatible storage (MinIO, Backblaze B2, etc.)

Requirements

• Obsidian 1.0.0+
• An S3-compatible storage bucket with API credentials