ProtocolProtocole

One TLS 1.3 port (47800 by default) serves HTTPS (/, /api/info, /app/xdesk.apk, /app/version) and the websocket /ws (RFC 6455); the extra video sockets of the web viewers open /lane.

• a text frame is one JSON object {"t": "<type>", ...} (control), 64 KiB at most;
• a binary frame is [u8 type][payload], every integer big endian, 32 MiB at most (a full 4K frame);
• the LAN discovery is a UDP broadcast on port 47801.

Un seul port TLS 1.3 (47800 par défaut) sert le HTTPS (/, /api/info, /app/xdesk.apk, /app/version) et la websocket /ws (RFC 6455) ; les sockets vidéo supplémentaires des viewers web ouvrent /lane.

• une trame texte est un objet JSON {"t": "<type>", ...} (contrôle), 64 Kio au plus ;
• une trame binaire est [u8 type][payload], tous les entiers en big endian, 32 Mio au plus (une image 4K complète) ;
• la découverte sur le LAN est un broadcast UDP sur le port 47801.

1. client → host
   TLS 1.3, group X25519MLKEM768 first (native clients: post-quantum groups only), certificate checked against the pinned fingerprint.
2. client → host
   hello: v kind name os device nonce udp.
3. host → client
   challenge: host version nonce salt kdf known.
4. client → host
   auth: method = code (web) or proof (native, HMAC(Argon2id(code, salt), transcript)), device, remember.
5. host → client
   pending while the person at the PC decides (unknown device), then welcome (session perms screen capture device proof) or denied (reason).

1. client → hôte
   TLS 1.3, groupe X25519MLKEM768 en premier (clients natifs : groupes post-quantiques seulement), certificat vérifié avec l'empreinte épinglée.
2. client → hôte
   hello : v kind name os device nonce udp.
3. hôte → client
   challenge : host version nonce salt kdf known.
4. client → hôte
   auth : method = code (web) ou proof (natif, HMAC(Argon2id(code, sel), transcript)), device, remember.
5. hôte → client
   pending pendant que la personne devant le PC décide (appareil inconnu), puis welcome (session perms screen capture device proof) ou denied (reason).

Each tile of a Frame starts with u16 x, u16 y, u16 w, u16 h, u8 enc, then:

Chaque tuile d'une Frame commence par u16 x, u16 y, u16 w, u16 h, u8 enc, puis :

Native viewers and the Android app, on the port of the server. A datagram is a 13-byte header in clear but authenticated, the AES-256-GCM payload and its 16-byte tag. Two random 256-bit keys per session (one per direction) come in the welcome.udp inside TLS; nonce = direction + sequence (never reused); a window of 2048 sequences drops replays; the host only answers an address that sent an authentic datagram.

Back to the websocket when UDP is blocked (2.5 s of unanswered hellos) or silent (4 s); a frame given up after 3 s asks a complete one.

Viewers natifs et appli Android, sur le port du serveur. Un datagramme est un en-tête de 13 octets en clair mais authentifié, le payload AES-256-GCM et son tag de 16 octets. Deux clés aléatoires de 256 bits par session (une par sens) arrivent dans le welcome.udp à l'intérieur de TLS ; nonce = sens + séquence (jamais réutilisé) ; une fenêtre de 2048 séquences écarte les rejeux ; l'hôte ne répond qu'à une adresse qui a envoyé un datagramme authentique.

Retour sur la websocket quand l'UDP est bloqué (2,5 s de hellos sans réponse) ou muet (4 s) ; une image abandonnée après 3 s demande une image complète.

Mouse buttons: 0 left, 1 middle, 2 right, 3 back, 4 forward. Client kinds: 0 gui, 1 tty, 2 web, 3 apk (an unknown kind is treated as web, the most restricted).

Boutons de souris : 0 gauche, 1 milieu, 2 droit, 3 précédent, 4 suivant. Types de client : 0 gui, 1 tty, 2 web, 3 apk (un type inconnu est traité comme web, le plus restreint).