Guida · Linux · X11 · Wayland
Mouse remoto per Linux: il tuo telefono, Wayland compreso
La maggior parte delle app mouse si ferma a X11. MouseOS comanda anche GNOME e KDE Plasma su Wayland: trackpad, tastiera, lo schermo, copia e incolla e tasti multimediali, dal telefono, sulla tua rete.
In breve: installa il .deb o l'.rpm, apri MouseOS sul telefono, fai clic una volta su CONSENTI. Gratis, su X11 come su Wayland, su Ubuntu, Debian, Mint, Fedora, openSUSE e Raspberry Pi OS. Nessun server tra il telefono e il computer.


Installare MouseOS su Linux
- Scarica il .deb (Ubuntu, Debian, Mint;
arm64per Raspberry Pi OS) o l'.rpm (Fedora, openSUSE) e installalo con il tuo gestore di pacchetti. Il pacchetto concedeuinputper Wayland e avvia MouseOS con la tua sessione. - Apri MouseOS, o rientra nella sessione. Su Wayland senza il pacchetto (una build tua), fai clic su CONSENTI IL CONTROLLO e inserisci la password una volta (dettagli sotto). Su X11 non c'è nulla da consentire.
- Apri MouseOS sul telefono, stessa rete. Fai clic su CONSENTI sul computer per quel telefono. Fatto.
Niente mouse sul computer? Un Raspberry Pi via SSH
Nulla di tutto questo richiede un clic. Installa il pacchetto, riavvia (o rientra nella sessione): MouseOS gira nella sessione desktop. Poi, via SSH o da un terminale qualsiasi della macchina:
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
Questi comandi parlano con l'app in esecuzione solo da questo computer: niente sulla rete può raggiungerli. Dal primo telefono in poi, il mouse è lui, anche per premere CONSENTI quando arriva il successivo.
X11 o Wayland: come arriva l’input
| Sessione | Come entra l'input |
|---|---|
| X11 | XTest: puntatore, pulsanti, entrambi gli assi di scorrimento, digitazione Unicode con qualsiasi layout. |
| Wayland | Un mouse e una tastiera virtuali tramite uinput, visti dal compositor come hardware reale. CONSENTI IL CONTROLLO esegue un solo passaggio pkexec: aggiunge una regola udev che marca /dev/uinput con uaccess, quindi accesso solo per l'utente collegato, e carica il modulo all'avvio. |
Preferisci farlo a mano? L'app mostra i tre comandi che eseguirebbe. Il volume passa da PipeWire o PulseAudio; i tasti multimediali raggiungono il lettore in primo piano.
Porte e rete
- Clic, tasti e stato: WebSocket su TCP 53317. Puntatore e scorrimento: UDP 53318, accettato solo da un telefono che hai consentito.
- Rilevamento: mDNS più un beacon UDP, quindi nessun IP da digitare. Se il firewall lo blocca, apri quelle due porte per la tua rete locale, oppure digita l'indirizzo mostrato dall'app.
- Nessun server in mezzo. Quello che fai non lascia mai la tua rete.
Domande frequenti
Funziona su Wayland?
Sì. Wayland non lascia muovere il puntatore alle app, quindi MouseOS usa un dispositivo di input virtuale (uinput), come un vero mouse e una vera tastiera. Il pacchetto lo configura; una build tua ti chiede di fare clic una volta su CONSENTI IL CONTROLLO e di inserire la password.
Quali distribuzioni?
Linux a 64 bit, x86_64 e arm64: un .deb per Ubuntu, Debian, Mint e Raspberry Pi OS (Ubuntu 22.04, Mint 21, Debian 12 e successivi), un .rpm per Fedora e openSUSE.
Posso usare il telefono come mouse remoto su Ubuntu o Linux Mint?
Sì. Installa il .deb, apri MouseOS sul telefono nella stessa rete e consenti quel telefono una volta sul computer. Funziona su Ubuntu 22.04 e Linux Mint 21 o successivi, su X11 e Wayland.
Funziona su un Raspberry Pi, o su un computer senza mouse?
Sì. Il .deb arm64 gira su Raspberry Pi OS 64 bit (Pi 4, 5, 400). Il pacchetto avvia MouseOS a ogni sessione desktop, e mouseos allow --next via SSH fa entrare il primo telefono, senza mouse sul computer.
Quali porte usa?
TCP 53317 (WebSocket per clic, tasti e stato) e UDP 53318 (puntatore e scorrimento), solo sulla rete locale. Il rilevamento usa mDNS e un beacon UDP.
MouseOS raccoglie quello che faccio?
No. Quello che fai con mouse e tastiera non lascia mai la tua rete. L’app invia solo statistiche d’uso anonime, che puoi disattivare.