Connect to a PCSe connecter à un PC
The four clients: the Qt viewer, the terminal client, a browser and the Android app, with their keys and gestures.Les quatre clients : le viewer Qt, le client terminal, un navigateur et l'appli Android, avec leurs touches et gestes.
Every client speaks to the same TLS port of the host (47800 by default) and gets the rights the host gives it.
Chaque client parle au même port TLS de l'hôte (47800 par défaut) et reçoit les droits que l'hôte lui donne.
1. The clientsLes clients
| Client | Start it | Shows |
|---|---|---|
Qt viewer (gui) | xdesk connect <address> -c <code>, xdesk viewer | the screen (fit / 1:1 / full screen), terminals in tabs |
Terminal client (tty) | xdesk connect <address> --tty | terminals, and the screen in truecolor half blocks (--screen) |
Browser (web) | https://<address>:<port> | the screen, terminals (xterm.js) |
Android app (apk) | the QR code, or /app/xdesk.apk offered by the web page | the web client full screen, certificate pinned |
xdesk connect 192.168.1.20 -c K7F-29Q-XM4 # Qt viewer
xdesk connect my-pc.ts.net --tty # remote terminal in this terminal
xdesk connect bore.pub:41234 --tty --screen # starts on the remote screen
xdesk connect --tty # connect page: known hosts, LAN scan, address and code
xdesk connect 192.168.1.20 --view-only # never send keyboard / mouse
xdesk scan # hosts announced on the LANThe native clients pin the certificate of the host on first use (the fingerprint is shown on both sides) and refuse a changed identity. Why.
| Client | Le lancer | Montre |
|---|---|---|
Viewer Qt (gui) | xdesk connect <adresse> -c <code>, xdesk viewer | l'écran (ajusté / 1:1 / plein écran), les terminaux en onglets |
Client terminal (tty) | xdesk connect <adresse> --tty | les terminaux, et l'écran en demi-blocs truecolor (--screen) |
Navigateur (web) | https://<adresse>:<port> | l'écran, les terminaux (xterm.js) |
Appli Android (apk) | le QR code, ou /app/xdesk.apk proposé par la page web | le client web en plein écran, certificat épinglé |
xdesk connect 192.168.1.20 -c K7F-29Q-XM4 # viewer Qt
xdesk connect my-pc.ts.net --tty # terminal distant dans ce terminal
xdesk connect bore.pub:41234 --tty --screen # démarre sur l'écran distant
xdesk connect --tty # page de connexion : hôtes connus, scan du LAN, adresse et code
xdesk connect 192.168.1.20 --view-only # n'envoie jamais clavier / souris
xdesk scan # hôtes annoncés sur le LANLes clients natifs épinglent le certificat de l'hôte à la première connexion (l'empreinte est affichée des deux côtés) et refusent une identité changée. Pourquoi.
2. Keys of the terminal clientTouches du client terminal
After ctrl+]:
| Key | Effect |
|---|---|
s / 0, 1-9, n p | screen tab, terminal N, next / previous tab |
t, w | new terminal, close this one |
c, d | control on / off, ctrl+alt+del |
+ -, f, r | image quality, frame rate, refresh |
pgup pgdn | scroll back (the wheel too) |
q, ?, ctrl+] | disconnect, keys, a real ctrl+] |
XDESK_TTY=ascii,16 forces what the terminal shows (ascii, unicode, mono, 16, 256, truecolor, no-mouse).
Après ctrl+] :
| Touche | Effet |
|---|---|
s / 0, 1-9, n p | onglet de l'écran, terminal N, onglet suivant / précédent |
t, w | nouveau terminal, fermer celui-ci |
c, d | contrôle on / off, ctrl+alt+del |
+ -, f, r | qualité d'image, fréquence, rafraîchir |
pgup pgdn | remonter l'historique (la molette aussi) |
q, ?, ctrl+] | déconnecter, touches, un vrai ctrl+] |
XDESK_TTY=ascii,16 force ce que le terminal affiche (ascii, unicode, mono, 16, 256, truecolor, no-mouse).
3. Browser and phoneNavigateur et téléphone
Scan the QR code of the panel with the camera: the app or the browser opens with the code filled in. Or open the address shown in the panel and type the code (or Scan).
| Gesture (trackpad mode) | Does |
|---|---|
| slide | move the pointer |
| tap / double tap | click / double click |
| tap then slide, hold then slide | drag |
| two fingers tap / slide | right click / scroll |
| pinch | zoom |
| three fingers tap | keyboard |
Direct touch mode: tap = click there, slide = drag, hold then lift = right click. A bar gives Esc, Tab, sticky Ctrl / Alt / Shift, Win, arrows, F1-F12, Ctrl+Alt+Del and Paste.
Warning. The certificate is self-signed: the browser asks to accept it once (compare the fingerprint with the panel). A browser cannot read the certificate, so it sends the code inside TLS without the Argon2id binding: prefer the native clients on an untrusted network, or the Tailscale name (real certificate).
Scanne le QR code du panneau avec l'appareil photo : l'appli ou le navigateur s'ouvre avec le code rempli. Ou ouvre l'adresse affichée dans le panneau et tape le code (ou Scan).
| Geste (mode trackpad) | Fait |
|---|---|
| glisser | déplacer le pointeur |
| tap / double tap | clic / double clic |
| tap puis glisser, appui long puis glisser | glisser-déposer |
| tap / glisser à deux doigts | clic droit / défilement |
| pincer | zoom |
| tap à trois doigts | clavier |
Mode toucher direct : tap = clic à cet endroit, glisser = glisser-déposer, appui long puis relâcher = clic droit. Une barre donne Échap, Tab, Ctrl / Alt / Maj collants, Win, flèches, F1-F12, Ctrl+Alt+Suppr et Coller.
Attention. Le certificat est auto-signé : le navigateur demande de l'accepter une fois (compare l'empreinte avec le panneau). Un navigateur ne peut pas lire le certificat, il envoie donc le code dans TLS sans la liaison Argon2id : préfère les clients natifs sur un réseau non sûr, ou le nom Tailscale (vrai certificat).