github.com/kimzam30/Nhako-beamPlanning
Nhako Beam
Device-to-device file transfer with no cloud, no size cap and no account. Peer to peer first; a self-hosted relay only when it has to.
- Status
- Planning
- Kind
- Direct file transfer
- Stage
- Specification only. The repository is the plan; no code yet.
- Platforms
- Windows and Linux (Tauri), Android (Kotlin)
- Core
- Rust: chunking, encryption, QUIC, resume
- Relay
- Self-hosted in Docker, signalling and forwarding only
- Started
- Last push
- License
- Not specified in the repo
- Built by
kimzam
The idea
An open-source alternative to proprietary direct-transfer apps. Files stream straight between devices whenever possible, and fall back to a relay you host yourself only when the network leaves no other way. No intermediate cloud storage, no freemium tier, no account.
Principles
- Direct first: try a LAN connection (mDNS) or WAN peer to peer (NAT traversal) before touching any relay.
- Relay as fallback: the relay only handles signalling and byte-forwarding, and never stores decrypted data.
- Chunked streaming: files are split into encrypted, checksummed chunks, and a transfer resumes from the last acknowledged one.
- Zero trust: end-to-end encryption (the Noise Protocol, or TLS 1.3 with mutual authentication).
The plan
| Phase | What it delivers |
|---|---|
| 1 | Core protocol: chunked streaming, encryption, QUIC, auto-resume, LAN discovery |
| 2 | Relay and infrastructure: the Docker relay, NAT traversal, a TURN-like fallback |
| 3 | Desktop clients for Windows and Linux, with drag and drop |
| 4 | Android: the system share sheet, background transfers, trusted-device auto-accept |
| 5 | Ecosystem: a relay directory, encrypted history, clipboard sharing, a plugin API |