ProtonDrive Linux Wiki

Technical documentation for the proton-drive-linux desktop client — a Tauri v2 app wrapping Proton Drive's WebClients frontend with a Rust backend.

## Projects

🖥️ proton-drive-linux

Tauri v2 desktop client: bidirectional file sync, SRP auth, multi-format packaging across 18+ Linux targets.

🦀 Drive SDK (Rust)

Rust crate for Proton Drive API: auth, file operations, encryption. Under development on feature/linux-client.

📐 System Architecture

Mermaid diagrams showing the Tauri shell, Rust modules, WebClients frontend, and their connections.

🔄 CI/CD Pipeline

Dual CI: GitHub Actions (primary builds) + GitLab CI (internal infrastructure). 18+ package targets.

## Module Map

graph TB
    subgraph "Desktop App"
        TAURI[Tauri v2 Shell]
        
        subgraph "Rust Modules"
            MAIN[main.rs
AppState + Proxy]
            LS[live_sync.rs
Bidirectional Sync]
            SDB[sync_db.rs
SQLite Persistence]
            NAV[proton_navigation.rs
SSO/CAPTCHA Routing]
            WV_C[webview_cookies.rs
Cookie Bridge]
        end
        
        subgraph "WebView"
            WC[Proton WebClients
Drive + Account + Verify]
        end
        
        SQLITE[(SQLite
WAL Mode)]
    end
    
    PROTON[Proton Drive API]
    
    MAIN --> LS
    MAIN --> SDB
    MAIN --> NAV
    MAIN --> WV_C
    LS --> SDB
    LS --> PROTON
    SDB --> SQLITE
    WV_C --> WC

## Quick Links - [Architecture deep dive →](/protondrive-linux/architecture/) - [Live Sync (bidirectional) →](/protondrive-linux/live-sync-module/) - [Auth module (SRP login) →](/protondrive-linux/auth-module/) - [Build system (18+ targets) →](/protondrive-linux/build-system/) - [CI/CD (GitHub + GitLab) →](/protondrive-linux/ci-pipeline/) - [SDK API reference →](/sdk/api-reference/)