Files

64 lines
2.9 KiB
Markdown

# NetDesk — Native Remote Desktop
A true native, cross-platform remote-desktop client. **Developed by [Akronlogic](https://akronlogic.com).**
Full IP ownership — built from scratch, no AGPL/third-party copyleft.
> Goal: a premium, TeamViewer-grade experience (RustDesk is our open-source
> *reference* for features and approach — we re-implement, we don't vendor it).
## Architecture
```
netdesk-native/
├── core/ Rust core library → the compiled engine (one codebase, all platforms)
│ signaling · E2E crypto · media transport · H.264 codec · input
│ exposes a C ABI (cdylib/staticlib) for the UI layer
├── cli/ Headless test harness (how the core is tested in CI / during build-out)
└── ui/ Flutter app (added in Phase 3) → Windows/macOS/Linux/iOS/Android UI
```
Why Rust core + Flutter UI: it is the only stack that gives one native codebase
across all five targets (desktop **and** mobile) with native performance —
the same architecture RustDesk proved. The heavy, latency-critical work lives in
Rust; the UI is Flutter calling in over the C ABI.
## Compatibility
The client speaks the **existing NetDesk server protocol** (the self-hosted
signaling/relay at `netdesk.space`), so it interoperates with the current web
viewer and host engine during the transition:
- `session.begin` → `session.challenge` → `session.auth` → `session.accept`
- Auth: `verifier = PBKDF2-HMAC-SHA256(password, salt, iters)`,
`proof = SHA256(nonce ‖ verifier)`
- E2E: ECDH P-256 → `SHA256(shared.x ‖ "e2e")` → AES-256-GCM
- Media: AES-GCM(`iv[12] ‖ ciphertext`), plaintext `= [chan][keyframe][H.264 Annex-B]`
## Roadmap
- [x] **Phase 1 — Core network + crypto** (this commit): WSS signaling, full
auth + E2E handshake, decrypted H.264 frame stream, headless CLI that
verifies a live session against the real server. *Tested.*
- [ ] **Phase 2 — Decode + render**: H.264 hardware decode (openh264/FFmpeg/
platform decoders), frame pacing, a minimal native window showing the
remote screen; input injection back to the host.
- [ ] **Phase 3 — Flutter UI**: the NetDesk app shell (connect screen, session
toolbar, address book), Akronlogic branding, over the Rust C ABI.
- [ ] **Phase 4 — Transport**: WebRTC P2P (direct) + TURN, matching the server's
3-tier path; adaptive bitrate.
- [ ] **Phase 5 — Feature parity**: multi-monitor, file transfer, clipboard,
audio, unattended access, auto-start service, auto-update.
- [ ] **Phase 6 — Packaging + signing**: signed installers per platform
(Akronlogic code-signing), store builds for iOS/Android.
## Build
```sh
# Rust core + CLI (Windows uses the GNU toolchain + MinGW-w64 binutils)
cargo build --release
# verify against a live host:
target/release/netdesk <host-id> <password> wss://netdesk.space/ws 10
```
© Akronlogic. All rights reserved.