Skip to content

CaptureGraph Sync#

CaptureGraph Sync is a command-line tool for downloading captured data from the server to your local machine.

Overview#

After users capture data via the iOS app and it's uploaded to the server, researchers use capturegraph-sync to aggregate that data locally for analysis.

iOS App → Server → capturegraph-sync → Local Analysis

Key Features#

Manifest-Driven Sync#

Instead of blindly downloading files, sync uses the ProcedureManifest to understand what data should exist:

  • Knows the expected file structure
  • Handles sessions and sequences correctly
  • Skips unexpected files

Hash-Based Efficiency#

The sync engine uses BLAKE2b hashing for efficiency and integrity:

  • Skip unchanged files: Compare local hashes with server
  • Resume interrupted syncs: Hash store persists between runs
  • Verify integrity: Detect corrupted downloads

Incremental Downloads#

Only download what's changed:

✓ photo.heic (skipped - unchanged)
✓ notes.json (skipped - unchanged)
↓ weather.json (downloading - new)

Section Contents#

CLI commands, configuration, and example workflows