What is Spacedrive?
Spacedrive is a local-first file manager that unifies data across devices without centralized cloud services. Files stay where they are. Spacedrive creates a content-aware index that makes them searchable, syncable, and manageable from anywhere.Why Spacedrive Exists
Computing was designed for single devices. File managers like Finder and Explorer assume your data lives on the computer in front of you. The shift to multi-device forced us into cloud ecosystems. Convenience required giving up data ownership. AI is accelerating this trend. Cloud services offer semantic search and intelligent analysis, but only if you upload your files to their infrastructure. Spacedrive is building the architecture for local AI on hardware you already own, on data that never leaves your control. This is infrastructure for the next era of computing.Current State
What Works Now (v2.0.0-alpha.1)
Core Infrastructure- Daemon-client architecture with persistent background operations
- Tauri desktop app with working interface
- CLI with full library, location, job, and network management
- Resumable job system with checkpointing and progress tracking
- Peer-to-peer library sync via Iroh/QUIC with NAT traversal
- Device pairing with BIP39 mnemonic codes
- Local network discovery (mDNS) and relay fallback
- Leaderless sync using Hybrid Logical Clocks (no central server)
- Device-owned data (locations, files) and shared resources (tags, collections)
- Incremental sync with watermarks for offline periods
- File indexing with shallow, content, and deep modes
- Content identity and deduplication across devices
- Unified addressing:
local://,s3://,content://URIs - Copy/move operations with atomic and streaming strategies
- Checksum verification and progress tracking
- Integration via OpenDAL (40+ services supported)
- S3, Google Drive, OneDrive, Dropbox, Azure Blob, GCS
- Cloud files indexed and searchable like local files
- Cross-storage operations (local to cloud, cloud to cloud)
- Thumbnail generation
- OCR text extraction
- Speech transcription
- Sampled content hashing (58KB identifies any file size)
- Semantic tagging with hierarchies and polymorphic naming
- Spaces for custom workspace layouts
- Collections for grouping files
- Ed25519 device identity with session key derivation
- XChaCha20-Poly1305 credential encryption
- OS keyring integration (Keychain, Credential Manager, Secret Service)
- macOS: Fully supported
- Linux: Fully supported
- Windows: Coming in alpha.2
- iOS & Android: Coming soon
Coming Soon
- alpha.2: Windows support
- Future releases:
- iOS app
- Android app
- Server edition for headless deployments
- Extension SDK (stable API)
- AI integration with local models
Prototypes (Not Public)
Native Swift apps (iOS, macOS) and a GPUI media viewer exist as private prototypes. These demonstrate type-safe native integration and platform-specific optimizations. They may become production apps if performance demands it.How It Works
Spacedrive treats files as first-class objects with content identity. A photo on your laptop and the same photo on your NAS are recognized as one piece of content. Core capabilities:- Search millions of files in under 100ms
- Preview operations before execution (conflicts, space savings, outcomes)
- Sync peer-to-peer without servers or consensus protocols
- Track redundancy across devices
- Full offline functionality
Testing & Feedback
This is an alpha release. We need community help validating:- macOS and Linux stability
- v1 to v2 library migration
- Multi-device sync scenarios
- Performance at scale
For Developers
Key technical docs:- Architecture Overview - System design and principles
- Data Model - How data is structured
- Content Addressing - Content identity system
- Library Sync - Multi-device synchronization
- Testing Guide - Test framework and patterns
Roadmap
The.tasks folder in the repo tracks core development work. Check the releases page for the public roadmap. These docs provide detailed technical reference.
Some guides document planned features that aren’t in alpha.1 yet. When
features aren’t ready, you’ll see callouts indicating their status.
Project Timeline
Spacedrive v2 development began in June 2025. This is a ground-up rewrite addressing lessons from the v1 alpha. The architecture is designed for long-term sustainability, not quick feature delivery. v2.0.0-alpha.1 released December 26, 2025 after six months of development. This alpha provides the core infrastructure for multi-device file management. Additional platforms and features will roll out in subsequent releases.Get Involved
- Test the code - Build from source, report bugs, validate cross-platform
- Join Discord - discord.gg/gTaF2Z44f5
- Read the whitepaper - whitepaper/spacedrive.pdf (work in progress)
- Explore architecture docs - Start with core/architecture
This is a living document. As development progresses through alpha and beta
releases, this page will be updated to reflect current status.
