Cloud Sync

Keep your bookmarks synchronized across multiple devices using cloud storage providers.

Overview

Cloud Sync allows you to:

Backup bookmarks to cloud storage
Sync bookmarks across multiple Macs
Restore bookmarks from cloud backups
Merge local and cloud bookmarks intelligently

Supported Providers

Google Drive Setup

Open the Cloud Sync dialog in the sidebar
Select Google Drive as your provider
Click Authenticate
Follow OAuth flow to grant access
Enter your access token

Requirements:

Google account
OAuth 2.0 access token with Drive API scope
https://www.googleapis.com/auth/drive.file permission

The plugin stores bookmarks in an app-specific folder, isolated from your other Drive files.

Dropbox Setup

Open the Cloud Sync dialog in the sidebar
Select Dropbox as your provider
Click Authenticate
Generate an access token from Dropbox App Console
Enter your access token

Requirements:

Dropbox account
App access token with files.content.write and files.content.read scopes

Keep your access tokens secure. Never share them publicly or commit them to version control.

Sync Operations

Upload

Upload your local bookmarks to cloud storage:

Click Cloud Sync in the sidebar
Select your provider and authenticate
Choose Upload action
Click Sync

Result: Local bookmarks are uploaded to cloud storage. Existing cloud backup is overwritten.

Download

Download bookmarks from cloud storage:

Click Cloud Sync in the sidebar
Select your provider and authenticate
Choose Download action
Click Sync

Result: Cloud bookmarks are displayed but not automatically merged with local. Review before importing.

Sync (Merge)

Intelligently merge local and cloud bookmarks:

Click Cloud Sync in the sidebar
Select your provider and authenticate
Choose Sync action
Click Sync

Result: Local and cloud bookmarks are merged with conflict resolution.

Conflict Resolution

When syncing, the plugin detects conflicts based on filepath + timestamp matching.

Conflict Handling

Same content → Keep one copy
Different content → Keep both with conflict markers
Local only → Add to merged result
Cloud only → Add to merged result

Conflicts are marked with:

{
  "title": "Bookmark Title [CONFLICT]",
  "description": "⚠️ Merged from cloud sync conflict",
  // ... other fields
}

Review conflict-marked bookmarks after sync and manually resolve by editing or deleting duplicates.

Sync Statistics

After each sync operation, the UI displays:

Added - New bookmarks merged from cloud
Updated - Existing bookmarks modified
Conflicts - Number of conflicts detected
Total - Final bookmark count

Backup Format

Bookmarks are stored in cloud as JSON files:

{
  "bookmarks": [
    {
      "id": "abc123",
      "title": "Important Scene",
      "timestamp": 125.5,
      "filepath": "/path/to/video.mp4",
      "description": "Key plot point",
      "tags": ["plot", "important"],
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z"
    }
  ],
  "metadata": {
    "version": "1.0.0",
    "timestamp": "2024-01-15T10:30:00Z",
    "deviceId": "unique-device-id",
    "bookmarkCount": 1
  }
}