Guide · Linux · X11 · Wayland
Souris à distance pour Linux : votre téléphone, Wayland compris
La plupart des applications de ce genre s'arrêtent à X11. MouseOS pilote aussi GNOME et KDE Plasma sous Wayland : pavé tactile, clavier, écran, copier-coller et touches multimédia, depuis votre téléphone, sur votre réseau.
En bref : installez le .deb ou le .rpm, ouvrez MouseOS sur le téléphone, cliquez une fois sur AUTORISER. Gratuit, sous X11 comme sous Wayland, sur Ubuntu, Debian, Mint, Fedora, openSUSE et Raspberry Pi OS. Aucun serveur entre le téléphone et l'ordinateur.


Installer MouseOS sous Linux
- Téléchargez le .deb (Ubuntu, Debian, Mint ;
arm64pour Raspberry Pi OS) ou le .rpm (Fedora, openSUSE) et installez-le avec votre gestionnaire de paquets. Le paquet accorde l'accès àuinputpour Wayland et lance MouseOS avec votre session. - Ouvrez MouseOS, ou reconnectez-vous à votre session. Sous Wayland, si vous avez compilé MouseOS vous-même au lieu d'installer le paquet, cliquez sur AUTORISER LE CONTRÔLE et saisissez votre mot de passe, une fois (détails plus bas). Sous X11, il n'y a rien à autoriser.
- Ouvrez MouseOS sur le téléphone, sur le même réseau. Sur l'ordinateur, cliquez sur AUTORISER pour ce téléphone. C'est prêt.
Pas de souris sur la machine ? Le cas du Raspberry Pi en SSH
Rien de ce qui précède n'exige un clic. Installez le paquet, puis redémarrez ou reconnectez-vous : MouseOS tourne dans la session de bureau. Ensuite, en SSH ou depuis un terminal de la machine :
mouseos allow --next 2m # the first phone to show up in two minutes is let in
mouseos status # name, address, permission, phones
mouseos list # linked, waiting, remembered
mouseos forget <phone> # it will ask again
Ces commandes parlent à l'application depuis cette machine seulement : rien sur le réseau ne peut les atteindre. Dès le premier téléphone accepté, la souris, c'est lui, y compris pour cliquer sur AUTORISER quand le suivant se présente.
X11 ou Wayland : par où passent les entrées
| Session | Par où passent les entrées |
|---|---|
| X11 | XTest : pointeur, boutons, défilement sur les deux axes, saisie Unicode quelle que soit la disposition du clavier. |
| Wayland | Une souris et un clavier virtuels créés avec uinput, que le compositeur voit comme du vrai matériel. AUTORISER LE CONTRÔLE lance une seule étape pkexec : elle ajoute une règle udev qui marque /dev/uinput avec uaccess, donc un accès réservé à l'utilisateur connecté, et charge le module au démarrage. |
Vous préférez le faire à la main ? L'application affiche les trois commandes qu'elle exécuterait. Le volume passe par PipeWire ou PulseAudio, et les touches multimédia vont au lecteur au premier plan.
Ports et réseau
- Clics, touches et état : WebSocket sur TCP 53317. Pointeur et défilement : UDP 53318, accepté seulement depuis un téléphone que vous avez autorisé.
- Découverte : mDNS et une balise UDP, donc aucune adresse IP à saisir. Si votre pare-feu la bloque, ouvrez ces deux ports sur votre réseau local, ou saisissez l'adresse qu'affiche l'application.
- Aucun serveur entre les deux. Ce que vous faites ne quitte pas votre réseau.
Questions fréquentes
MouseOS fonctionne-t-il sous Wayland ?
Oui. Wayland interdit aux applications de déplacer le pointeur. MouseOS crée donc un périphérique d'entrée virtuel (uinput), que le système voit comme une vraie souris et un vrai clavier. Le paquet le configure. Si vous compilez MouseOS vous-même, il vous demande de cliquer une fois sur AUTORISER LE CONTRÔLE et de saisir votre mot de passe.
Sur quelles distributions ?
Linux 64 bits, en x86_64 et en arm64. Un .deb pour Ubuntu, Debian, Mint et Raspberry Pi OS (à partir d'Ubuntu 22.04, Mint 21 et Debian 12), un .rpm pour Fedora et openSUSE.
Puis-je utiliser mon téléphone comme souris à distance sous Ubuntu ou Linux Mint ?
Oui. Installez le .deb, ouvrez MouseOS sur le téléphone, sur le même réseau, et autorisez ce téléphone une fois sur l'ordinateur. Ça marche sur Ubuntu 22.04 et Linux Mint 21 ou plus récents, sous X11 comme sous Wayland.
Et sur un Raspberry Pi, ou une machine sans souris ?
Oui. Le .deb arm64 tourne sur Raspberry Pi OS 64 bits (Pi 4, 5 et 400). Le paquet lance MouseOS à chaque session de bureau, et la commande mouseos allow --next, en SSH, laisse entrer le premier téléphone sans aucune souris sur la machine.
Quels ports MouseOS utilise-t-il ?
TCP 53317, un WebSocket pour les clics, les touches et l'état, et UDP 53318 pour le pointeur et le défilement. Sur le réseau local uniquement. La découverte passe par mDNS et une balise UDP.
MouseOS collecte-t-il ce que je fais ?
Non. Ce que vous faites avec la souris et le clavier ne quitte pas votre réseau. L'application envoie seulement des statistiques d'usage anonymes, que vous pouvez désactiver.