xdeskv1.0.0
User guideGuide utilisateur

Getting startedPremiers pas

Install xdesk on Linux or Windows, then share a PC for the first time.Installer xdesk sous Linux ou Windows, puis partager un PC pour la première fois.

xdesk is one binary: the same xdesk shares a PC (the host) or connects to one (the client).

xdesk est un seul binaire : le même xdesk partage un PC (l'hôte) ou s'y connecte (le client).

1. Install on LinuxInstaller sous Linux

Signed RPM (Fedora), DEB (Debian / Ubuntu) and Arch packages. Every package repository of TsukiNi22 at once, with my-universe:

curl -fsSL https://tsukini22.github.io/my-universe/install.sh | bash -s
sudo dnf install xdesk          # or: sudo apt install xdesk / sudo pacman -S xdesk

Or only the repository of xdesk, with its setup.sh:

curl -fsSL https://raw.githubusercontent.com/TsukiNi22/xdesk/main/setup.sh | bash -s -- --install
Argument of setup.shEffect
--installAlso install the package (by default only the repository and the GPG key)
--preThe pre-release package (xdesk-pre)
--windowsThe Windows packages (mingw64-xdesk, MinGW sysroot, rpm / deb only)
--no-sudoRun without sudo (already root)

From the sources instead (dependencies, libutils, build, ~/.local/bin/xdesk, menu entries):

git clone https://github.com/TsukiNi22/xdesk.git && cd xdesk
scripts/install.sh --deps --apk --uinput   # --apk: embed the Android app, --uinput: remote control on Wayland
scripts/install.sh --autostart             # host panel at login (tray)

Paquets RPM (Fedora), DEB (Debian / Ubuntu) et Arch signés. Tous les dépôts de paquets de TsukiNi22 d'un coup, avec my-universe :

curl -fsSL https://tsukini22.github.io/my-universe/install.sh | bash -s
sudo dnf install xdesk          # ou : sudo apt install xdesk / sudo pacman -S xdesk

Ou seulement le dépôt de xdesk, avec son setup.sh :

curl -fsSL https://raw.githubusercontent.com/TsukiNi22/xdesk/main/setup.sh | bash -s -- --install
Argument de setup.shEffet
--installInstalle aussi le paquet (par défaut seulement le dépôt et la clé GPG)
--preLe paquet de pré-release (xdesk-pre)
--windowsLes paquets Windows (mingw64-xdesk, sysroot MinGW, rpm / deb seulement)
--no-sudoLancer sans sudo (déjà root)

Ou depuis les sources (dépendances, libutils, compilation, ~/.local/bin/xdesk, entrées de menu) :

git clone https://github.com/TsukiNi22/xdesk.git && cd xdesk
scripts/install.sh --deps --apk --uinput   # --apk : embarquer l'appli Android, --uinput : contrôle à distance sous Wayland
scripts/install.sh --autostart             # panneau de l'hôte à la connexion (tray)

2. Install on WindowsInstaller sous Windows

From the xdesk-windows-x64.zip of a release, in PowerShell:

powershell -ExecutionPolicy Bypass -File install.ps1             # %LOCALAPPDATA%\Programs\xdesk, PATH, Start menu, firewall
powershell -ExecutionPolicy Bypass -File install.ps1 -Autostart
powershell -ExecutionPolicy Bypass -File install.ps1 -Uninstall

install.ps1 downloads the latest release itself when it is not run from the extracted zip (-Zip <file> for a local one).

Warning. The Windows build is checked with MinGW but not yet run on a real Windows. Known limits.

Depuis le xdesk-windows-x64.zip d'une release, dans PowerShell :

powershell -ExecutionPolicy Bypass -File install.ps1             # %LOCALAPPDATA%\Programs\xdesk, PATH, menu Démarrer, pare-feu
powershell -ExecutionPolicy Bypass -File install.ps1 -Autostart
powershell -ExecutionPolicy Bypass -File install.ps1 -Uninstall

install.ps1 télécharge lui-même la dernière release quand il n'est pas lancé depuis le zip extrait (-Zip <fichier> pour un zip local).

Attention. Le build Windows est vérifié avec MinGW mais pas encore lancé sur un vrai Windows. Limites connues.

3. Share this PCPartager ce PC

  1. Run xdesk: the panel opens (Qt window, or a terminal panel without display).
  2. Press Start sharing: sharing starts off at each launch.
  3. Give the one time code (K7F-29Q-XM4) or show the QR code.
  4. Accept the device when the panel asks (an unknown device is refused after 30 s).

On the other PC: xdesk connect <address> -c <code>, or open https://<address>:47800 in a browser. Next: share a PC, connect.

  1. Lancer xdesk : le panneau s'ouvre (fenêtre Qt, ou panneau dans le terminal sans affichage).
  2. Appuyer sur Start sharing : le partage est arrêté à chaque lancement.
  3. Donner le code à usage unique (K7F-29Q-XM4) ou montrer le QR code.
  4. Accepter l'appareil quand le panneau le demande (un appareil inconnu est refusé après 30 s).

Sur l'autre PC : xdesk connect <adresse> -c <code>, ou ouvrir https://<adresse>:47800 dans un navigateur. Ensuite : partager un PC, se connecter.