How rtariq2015/raspi-cloud-sync-pro works
Raspi Cloud Sync Pro turns a Raspberry Pi into a USB file-capture appliance with local retention and verified cloud backups. The main workflow is Windows copy and safe Eject, guarded capture into durable staging, then a background worker that uploads and verifies files over built-in Wi-Fi. Distinct supporting capabilities include experimental MTP and optional Samba ingestion, dashboard access, and Google web setup. Edges reflect README-described flows or relationships visible in the supplied source index and excerpts; several listed subsystems were not sampled in full.
Main entry points: mass_storage_appliance.py Mass-storage appliance · staged_worker.py Backup worker · staging.py Durable staging · dashboard.py Dashboard
Components 21
USB capture
- Mass-storage appliance
src/raspi_cloud_sync_pro/mass_storage_appliance.py - USB gadget control
src/raspi_cloud_sync_pro/gadget.py - Linux gadget backend
src/raspi_cloud_sync_pro/linux_gadget.py - Image enrollment
src/raspi_cloud_sync_pro/image_enrollment.py - Image policy
src/raspi_cloud_sync_pro/mass_storage_image.py - Storage ownership
src/raspi_cloud_sync_pro/storage.py - Capture admission
src/raspi_cloud_sync_pro/capture_space.py - MTP ingestion
src/raspi_cloud_sync_pro/mtp_ingest.py - Samba ingestion
src/raspi_cloud_sync_pro/smb_ingest.py
Backup pipeline
- Durable staging
src/raspi_cloud_sync_pro/staging.py - Backup worker
src/raspi_cloud_sync_pro/staged_worker.py - Backup engine
src/raspi_cloud_sync_pro/engine.py - Backup history
src/raspi_cloud_sync_pro/history.py
Cloud integrations
- Google upload dispatch
src/raspi_cloud_sync_pro/google_upload_dispatcher.py - Google setup broker
src/raspi_cloud_sync_pro/google_broker.py - Google destination
src/raspi_cloud_sync_pro/google_destination.py
Dashboard and networking
- Wi-Fi policy
src/raspi_cloud_sync_pro/network.py - Dashboard
src/raspi_cloud_sync_pro/dashboard.py
Other components
- Windows host
- Google Drive
- Owner or viewer
Connections 20
- Windows host → Mass-storage appliance: copies and ejects
- Mass-storage appliance → USB gadget control: controls gadget
src/raspi_cloud_sync_pro/mass_storage_appliance.py - USB gadget control → Linux gadget backend: uses backend
src/raspi_cloud_sync_pro/gadget.py - Mass-storage appliance → Durable staging: captures files
- Mass-storage appliance → Storage ownership: guards capture
src/raspi_cloud_sync_pro/mass_storage_appliance.py - Mass-storage appliance → Capture admission: checks capacity
src/raspi_cloud_sync_pro/mass_storage_appliance.py - Image enrollment → Image policy: validates image
src/raspi_cloud_sync_pro/image_enrollment.py - MTP ingestion → Durable staging: publishes batches
src/raspi_cloud_sync_pro/mtp_ingest.py - Samba ingestion → Durable staging: stages files
src/raspi_cloud_sync_pro/smb_ingest.py - Durable staging → Backup worker: queues batches
src/raspi_cloud_sync_pro/staged_worker.py - Backup worker → Backup engine: runs backup
src/raspi_cloud_sync_pro/staged_worker.py - Backup engine → Backup history: records status
src/raspi_cloud_sync_pro/engine.py - Backup worker → Wi-Fi policy: checks connectivity
src/raspi_cloud_sync_pro/staged_worker.py - Backup worker → Google upload dispatch: dispatches uploads
- Google upload dispatch → Google destination: uses destination
src/raspi_cloud_sync_pro/google_upload_dispatcher.py - Google destination → Google Drive: uploads and verifies
- Google setup broker → Google destination: prepares destination
src/raspi_cloud_sync_pro/google_broker.py - Owner or viewer → Dashboard: browses files
- Dashboard → Backup history: shows backup history
- Dashboard → Google setup broker: requests setup