ContextQMD
Back to Spacedrive

Welcome to Spacedrive

docs/overview/introduction.mdx

0.4.37.1 KB
Original Source
<Callout icon="planet-ringed" color="#36A3FF" iconType="solid"> **v2.0.0-alpha.1 Released: December 26, 2025**

The complete ground-up rewrite is here. This is an alpha release for testing and feedback. macOS and Linux are supported now. Windows support coming in alpha.2.

Read the full release notes for more details on the rewrite.

</Callout>

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.

<Frame> </Frame>

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

Multi-Device Sync

  • 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 Management

  • 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

Cloud Storage

  • 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)

Media & Analysis

  • Thumbnail generation
  • OCR text extraction
  • Speech transcription
  • Sampled content hashing (58KB identifies any file size)

Organization

  • Semantic tagging with hierarchies and polymorphic naming
  • Spaces for custom workspace layouts
  • Collections for grouping files

Security

  • Ed25519 device identity with session key derivation
  • XChaCha20-Poly1305 credential encryption
  • OS keyring integration (Keychain, Credential Manager, Secret Service)

Platform Support

  • 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

Files stay in place. Spacedrive makes them universally addressable with rich metadata.

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
<Tip> macOS and Linux users: Test indexing, multi-device sync, and cloud integration. Report bugs on GitHub or Discord. All feedback helps improve stability for the beta release. </Tip>

For Developers

<Warning> **Most architecture docs are in the Developer section.** The core technical documentation lives under [Architecture](/core/architecture), not in overview guides. </Warning>

Key technical docs:

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.

<Info> Some guides document planned features that aren't in alpha.1 yet. When features aren't ready, you'll see callouts indicating their status. </Info>

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.

Screenshots

<div style={{ display: 'flex', flexDirection: 'column', gap: '2rem' }}> <Frame> </Frame> <Frame> </Frame> <Frame> </Frame> <Frame> </Frame> <Frame> </Frame> <Frame> </Frame> </div>

Get Involved

<Note> This is a living document. As development progresses through alpha and beta releases, this page will be updated to reflect current status. </Note>