Native desktop client for VNOX: Rust + Slint, Opus voice, no Electron
Find a file
loki5512344 7d488faf59
fix(client): derive voice status from a single state machine
The status bar and voice page kept saying the room was being joined while
the sidebar already reported a connected voice. Clicking the room you were
already in set a free-text 'joining' message that nothing cleared, because
the server does not answer a repeated join, and the voice page showed its
joining label whenever the member list was empty.

Joining is now an explicit voice state. The sidebar, the voice page and the
status text all read one derived status; a repeated click only shows the
room, and a server error cancels a pending join.
2026-10-25 10:03:21 +01:00
.cargo Initial commit: split VNOX monorepo into VNOX-Client 2026-07-09 11:52:57 +02:00
docs docs: record client UX defects found in the first live run 2026-10-24 23:47:14 +02:00
examples/themes feat(client): redesign native UI, themes, settings and avatars 2026-10-24 14:23:48 +02:00
patches feat(client): redesign native UI, themes, settings and avatars 2026-10-24 14:23:48 +02:00
protocol feat(client): TLS 1.3 control connection with SPKI pinning and LNEx v3 2026-10-24 22:05:19 +02:00
scripts feat(client): protocol v2 wire layer, screen sharing, channel webhooks and secure voice 2026-10-24 16:51:15 +02:00
src fix(client): derive voice status from a single state machine 2026-10-25 10:03:21 +01:00
tests feat(client): TLS 1.3 control connection with SPKI pinning and LNEx v3 2026-10-24 22:05:19 +02:00
translations fix(client): surface audio failures and use adaptive voice activation 2026-10-25 10:03:20 +01:00
.gitattributes feat(client): redesign native UI, themes, settings and avatars 2026-10-24 14:23:48 +02:00
.gitignore feat(client): redesign native UI, themes, settings and avatars 2026-10-24 14:23:48 +02:00
build.rs feat(client): protocol v2 wire layer, screen sharing, channel webhooks and secure voice 2026-10-24 16:51:15 +02:00
Cargo.lock feat(client): TLS 1.3 control connection with SPKI pinning and LNEx v3 2026-10-24 22:05:19 +02:00
Cargo.toml feat(client): TLS 1.3 control connection with SPKI pinning and LNEx v3 2026-10-24 22:05:19 +02:00
CHANGELOG.md docs: describe TLS 1.3 control connection and LNEx v3 in client docs 2026-10-24 22:05:19 +02:00
LICENSE add GPL-3.0 license 2026-07-09 12:05:04 +02:00
README.md docs: describe TLS 1.3 control connection and LNEx v3 in client docs 2026-10-24 22:05:19 +02:00

VNOX — Client

Native desktop client for VNOX. Voice, text, no cloud.

License: GPL-3.0 Rust Status: Phase 1


What is this?

The official desktop client for VNOX — a self-hosted voice and text communication platform. Connects to a VNOX server over the LNEx protocol.

  • Connects to gateway via TCP (text, auth, channels, guilds, DMs)
  • Connects to voice node via UDP (encrypted Opus voice packets)
  • Opus audio encoding/decoding with adaptive jitter buffer
  • Native UI built with Slint — no Electron, no web views

Features

Implemented

  • Auth: Ed25519 keypair generation, challenge-response login, reconnect with exponential backoff
  • Encryption: TLS 1.3 (rustls) on the control connection with certificate pinning (trust on first use), ChaCha20-Poly1305 on UDP voice
  • Text chat: Persistent history, reactions, replies, edit, delete, typing indicators, read receipts
  • Channel management: Join, leave, create, delete; text and voice channels
  • Guilds: Create, list, leave, member list with roles, kick, audit log viewer
  • Roles: Role list, assign/unassign with permission checks
  • Direct Messages: 1:1 DMs with persistent history, unread badges, search
  • Friends: Requests, accept/decline, Online/All/Pending/Blocked tabs
  • Presence: Online/Idle/DND/Invisible, custom status text, activity display
  • Voice: PTT / VAD / always-on modes, configurable bitrate, per-user volume
  • Jitter buffer: Adaptive mode, configurable target latency
  • Noise suppression: RNNoise (feature-gated, off by default)
  • Identity vault: Optional Argon2id + ChaCha20-Poly1305 encrypted keyfile
  • Keyfile export/import: Encrypted or plain JSON with passphrase
  • Bookmarks: Save/remove server nodes in connect screen

Planned

  • In-game overlay (Phase 2)
  • Federation support (Phase 3)
  • Mobile client (Phase 3)

Status

Phase 1 is implemented. Not production ready.

Feature Status
Connect to server ✅ Working
Text chat ✅ Working
Channel management ✅ Working
Guilds & roles ✅ Working
Direct Messages ✅ Working
Friends & presence ✅ Working
Voice (send/receive) 🔧 Partial (audio pipeline)
Encryption ✅ TLS 1.3 (TCP) + ChaCha20-Poly1305 (voice)
In-game overlay 🔲 Phase 2
Mobile client 🔲 Phase 3

See docs/00-status.md for a full breakdown.


Quick start

Requirements: Rust 1.94+, a running VNOX Server

Linux builds also need audio/protocol prerequisites and FreeType/fontconfig development libraries (libfreetype6-dev libfontconfig1-dev on Ubuntu); native file selection uses the desktop portal.

# Terminal 1 — gateway
cargo run -p vnox-gateway -- --config dev/config.toml

# Terminal 2 — voice node
cargo run -p vnox-voice-node -- --config dev/config.toml

# Terminal 3 — client
cargo run -p vnox-client

The client connects to 127.0.0.1:7600 by default. You can change the address in the UI on the connect screen.

Opus on Windows

audiopus_sys builds libopus from source via CMake. CMake 4.x policy flag is already set in .cargo/config.toml — no manual steps needed.


Tech stack

Layer Technology
UI Slint
Networking Tokio (async TCP + UDP)
Audio cpal + rodio + opus + rnnoise
Identity ed25519-dalek + x25519-dalek
Crypto ChaCha20-Poly1305 + Argon2id
Protocol LNEx v1 (JSON, Phase 1)

Project structure

src/
├── main.rs             # Entry point
├── ui/                 # Slint UI (slint files + Rust glue)
├── net/                # LNEx TCP + UDP networking
│   ├── crypto/         # Session encryption
│   ├── framing/        # Packet read/write
│   ├── voice/          # UDP voice send/recv
│   └── session/        # Connection lifecycle, reconnection
├── audio/              # Audio pipeline
│   ├── capture.rs      # Mic → Opus encode
│   ├── playback.rs     # Opus decode → speaker
│   ├── config.rs       # Bitrate, VAD, jitter settings
│   └── processing/     # VAD, noise suppression
├── identity_vault.rs   # Argon2id-encrypted keyfile
├── app.rs              # UI state and event dispatch
└── jitter/             # Jitter buffer

License

Client code: GPL-3.0 — see LICENSE
LNEx protocol specification: CC0 (public domain)