Skip to content

the9ines/localbolt-native

Repository files navigation

LocalBolt Native

Native macOS desktop app for LocalBolt. Encrypted peer-to-peer file transfer.

Download

LocalBolt 2.0.0 for macOS →

Platform macOS 14 (Sonoma) or later
Architecture Apple Silicon (M1 / M2 / M3 / M4)
Format DMG — drag to Applications
Signing Ad-hoc (not notarized)

First launch: Right-click the app, click Open, then click Open again in the dialog. This only needs to be done once — macOS remembers the exception.

Checksum verification: see SHA256SUMS.txt on the release page.

Architecture

LocalBolt Native is a SwiftUI macOS app with a Rust cryptographic core and a bundled bolt-daemon sidecar.

Layer Technology Role
UI shell SwiftUI macOS-native drag-and-drop, transfer progress, device discovery
FFI bridge Rust → C-ABI static library (libbolt_native_bridge.a) Cryptographic operations, protocol logic
Transport daemon bolt-daemon sidecar WebSocket (default) + WebTransport (browser↔native)
Encryption Bolt Transfer Ratchet (BTR) Per-transfer DH ratchet + ChaCha20-Poly1305 chunk encryption
Identity Profile Envelope v1 NaCl-box outer encryption with Ed25519 identity keys

Browser users at localbolt.app connect seamlessly with native app users — same protocol, same encryption.

Structure

localbolt-native/
├── native/
│   ├── shared/    # Rust C-ABI FFI bridge (libbolt_native_bridge.a)
│   └── macos/     # SwiftUI app, build scripts, DMG packaging
├── signal/        # Rust signal server crate (vendored bolt-rendezvous)
└── docs/          # State, changelog, distribution plan

Ecosystem

LocalBolt Native is part of the Bolt Protocol ecosystem.

Relationship Repository
Ecosystem governance bolt-ecosystem
Protocol spec bolt-protocol
SDK (Rust) bolt-core-sdk
Daemon bolt-daemon
Signal server (subtree) bolt-rendezvous
Web app localbolt-v3
Self-hosted localbolt

This is an open-source project. Free to use, build, and modify.

Related

Historical Note

This repository previously contained a Tauri v2 cross-platform implementation (last Tauri release: v1.2.24). That implementation is frozen. The current native app is SwiftUI + Rust, macOS-only. The web/ and src-tauri/ directories in this repo are archived Tauri-era code and are not part of the current build.

License

MIT — built by the9ines

About

LocalBolt — Native macOS desktop app for encrypted P2P file transfer

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors