Share a PCPartager un PC
The host panel: the sharing switch, the code and its QR code, the approval, the sessions and their rights, the devices.Le panneau de l'hôte : l'interrupteur du partage, le code et son QR code, l'approbation, les sessions et leurs droits, les appareils.
The person in front of the PC keeps the control: they see every session live and decide who stays.
La personne devant le PC garde la main : elle voit chaque session en direct et décide qui reste.
1. The panelLe panneau
xdesk (or xdesk host) opens the panel: a Qt window (Auto / Light / Dark, tray icon) or, with --tty or without a display, the same panel in the terminal. Both have 5 pages: overview, sessions, devices, logs, settings.
Sharing starts off. Start / Stop sharing (bottom left, the tray, s in the terminal panel) starts or stops the server, the exposure and the capture without quitting; each start gives a new code.
xdesk (ou xdesk host) ouvre le panneau : une fenêtre Qt (Auto / Clair / Sombre, icône dans le tray) ou, avec --tty ou sans affichage, le même panneau dans le terminal. Les deux ont 5 pages : vue d'ensemble, sessions, appareils, logs, réglages.
Le partage démarre arrêté. Start / Stop sharing (en bas à gauche, le tray, s dans le panneau terminal) démarre ou arrête le serveur, l'exposition et la capture sans quitter ; chaque démarrage donne un nouveau code.
2. The codeLe code
| Format | 9 characters of Crockford base32 (K7F-29Q-XM4): 45 bits |
| Rotation | after each use, every 300 s (codeLifetime), at each start of the sharing |
| Wrong codes | 5 from one address (maxAuthFailures): that address is banned 1 h and the code changes |
| QR code | xdesk://host:port?fp=..&code=.. for the Android app (pins the certificate), https://host:port/?code=.. for a browser |
| Format | 9 caractères en base32 de Crockford (K7F-29Q-XM4) : 45 bits |
| Rotation | après chaque usage, toutes les 300 s (codeLifetime), à chaque démarrage du partage |
| Mauvais codes | 5 depuis une adresse (maxAuthFailures) : cette adresse est bannie 1 h et le code change |
| QR code | xdesk://host:port?fp=..&code=.. pour l'appli Android (épingle le certificat), https://host:port/?code=.. pour un navigateur |
3. ApprovalApprobation
An unknown device waits for Accept / Accept & trust / Refuse (refused after 30 s). The approval setting: untrusted (every device not trusted yet, default), always, never (the code is enough). A trusted device reconnects without code, with its 256-bit device secret.
Un appareil inconnu attend Accepter / Accepter et faire confiance / Refuser (refusé après 30 s). Le réglage approval : untrusted (tout appareil sans confiance, par défaut), always, never (le code suffit). Un appareil de confiance se reconnecte sans code, avec son secret d'appareil de 256 bits.
4. Sessions and rightsSessions et droits
The sessions page shows each one live: device, client (gui, tty, web, apk), address, mode, rights, FPS, latency, bandwidth, last input. Opening one shows every input it sends and mirrors its terminals.
| Right | Allows |
|---|---|
| view | see the screen |
| control | keyboard and mouse |
| terminal | open terminals (4 at most per session) |
| clipboard | read and write the clipboard |
Rights change live. While you use the panel, remote input is paused; a viewer can ask its control back (granted after 60 s unless refused).
La page des sessions montre chacune en direct : appareil, client (gui, tty, web, apk), adresse, mode, droits, FPS, latence, débit, dernière entrée. En ouvrir une montre chaque entrée qu'elle envoie et le miroir de ses terminaux.
| Droit | Permet |
|---|---|
| view | voir l'écran |
| control | clavier et souris |
| terminal | ouvrir des terminaux (4 au plus par session) |
| clipboard | lire et écrire le presse-papiers |
Les droits changent en direct. Pendant que tu utilises le panneau, les entrées à distance sont en pause ; un viewer peut redemander le contrôle (accordé après 60 s sauf refus).
5. DevicesAppareils
Trusted, known and banned devices and banned addresses, one record per machine. Trust, untrust, forget and unban are only possible on this PC, and refused while a remote session has control or a terminal. Lifting a ban asks the word unban typed.
xdesk devices # known / trusted / banned devices and addresses
xdesk unban <device id | address> # host stopped, the word unban typedAppareils de confiance, connus et bannis, et adresses bannies, un enregistrement par machine. Faire confiance, retirer la confiance, oublier et débannir ne sont possibles que sur ce PC, et refusés tant qu'une session à distance a le contrôle ou un terminal. Lever un ban demande de taper le mot unban.
xdesk devices # appareils et adresses connus / de confiance / bannis
xdesk unban <id d'appareil | adresse> # hôte arrêté, le mot unban tapé6. Keys of the terminal panelTouches du panneau terminal
Key (? shows them) | Effect |
|---|---|
1-5, tab | pages overview / sessions / devices / logs / settings |
s, q | start / stop sharing, quit |
a t r | accept / accept & trust / refuse a connection |
n y enter c e (overview) | new code, copy the code, QR code, copy its link, exposure |
v c t p m k b K (sessions) | rights view / control / terminal / clipboard, watch its terminals, disconnect, ban, disconnect all |
T U f u (devices) | trust, untrust, forget, unban |
l c / enter (logs) | level, category, search, details |
Touche (? les affiche) | Effet |
|---|---|
1-5, tab | pages vue d'ensemble / sessions / appareils / logs / réglages |
s, q | démarrer / arrêter le partage, quitter |
a t r | accepter / accepter et faire confiance / refuser une connexion |
n y enter c e (vue d'ensemble) | nouveau code, copier le code, QR code, copier son lien, exposition |
v c t p m k b K (sessions) | droits voir / contrôle / terminal / presse-papiers, suivre ses terminaux, déconnecter, bannir, tout déconnecter |
T U f u (appareils) | confiance, retirer la confiance, oublier, débannir |
l c / enter (logs) | niveau, catégorie, recherche, détails |