How spacedriveapp/spacedrive works
Spacedrive is personal data infrastructure: it catalogs files across user-controlled sources and exposes common operations through multiple clients. The main workflow is a person using a client to query or change a library; registered operations run through the daemon against indexed sources, with jobs tracking long-running work. The README also describes peer access, mounts, history, protection, and extensions as product capabilities. Some subsystem links below reflect README statements rather than sampled implementation; those use the README as evidence.
Main entry points: mod.rs Registered operations · dispatch.rs Daemon API · manager.rs Library manager · space.rs Library database
Components 22
User clients
- CLI
apps/cli/src/main.rs - Desktop app
apps/tauri/src-tauri/src/server.rs - Web interface
apps/web/src/main.tsx - Mobile app
apps/mobile/src/client/SpacedriveClient.ts - Photos app
apps/native/src/main.rs - TypeScript SDK
packages/ts-client/src/client.ts
Operations runtime
- Daemon API
core/src/infra/daemon/dispatch.rs - Registered operations
core/src/ops/mod.rs - Durable jobs
core/src/infra/job/manager.rs
Library and catalog
- Library manager
core/src/library/manager.rs - Resource model
core/src/domain/resource.rs - Library database
core/src/infra/db/entities/space.rs - Live indexing
core/src/ops/indexing/job.rs - Search pipeline
core/src/ops/search/pipeline.rs
Remote access
- Peer synchronization
core/src/infra/sync/peer_log.rs - Source mounts
core/src/ops/mounts/mod.rs
Product capabilities
- File operations
core/src/ops/files/planner.rs - Volumes and sources
core/src/volume/manager.rs - History and snapshots
core/src/infra/sync/event_log/mod.rs - Extensions
core/src/infra/extension/manager.rs - External adapters
crates/archive/src/engine.rs
Other components
- Person or software
Connections 29
- Person or software → CLI: uses
- Person or software → Desktop app: uses
- Person or software → Web interface: uses
- Person or software → Mobile app: uses
- Person or software → Photos app: uses
- Person or software → TypeScript SDK: invokes
- CLI → Daemon API: sends requests
apps/cli/src/main.rs - Desktop app → Daemon API: connects
- Web interface → Daemon API: calls operations
- Mobile app → Daemon API: calls operations
- Photos app → Daemon API: reads snapshots
apps/native/src/main.rs - TypeScript SDK → Daemon API: calls operations
- Daemon API → Registered operations: dispatches
- Registered operations → Library manager: uses library
- Registered operations → Durable jobs: starts jobs
- Library manager → Library database: persists records
core/src/library/manager.rs - Library manager → Resource model: manages resources
core/src/library/manager.rs - Registered operations → Live indexing: runs indexing
- Registered operations → Search pipeline: runs search
core/src/ops/search/pipeline.rs - Registered operations → File operations: validates and executes
- Live indexing → Library database: updates catalog
- Search pipeline → Library database: queries catalog
- Volumes and sources → Library manager: tracks changes
core/src/volume/manager.rs - Library manager → Peer synchronization: synchronizes models
- Registered operations → History and snapshots: exposes history
- Registered operations → Source mounts: serves mounts
- Peer synchronization → Source mounts: streams source bytes
- Registered operations → Extensions: runs extensions
- Volumes and sources → External adapters: uses external sources