Guia · Linux · X11 · Wayland

Mouse remoto para Linux: seu celular, com Wayland incluído

A maioria dos apps de mouse para no X11. O MouseOS controla também GNOME e KDE Plasma no Wayland: trackpad, teclado, a tela, copiar e colar e teclas de mídia, pelo celular, na sua rede.

Em resumo: instale o .deb ou o .rpm, abra o MouseOS no celular, clique uma vez em PERMITIR. Grátis, no X11 e no Wayland, no Ubuntu, Debian, Mint, Fedora, openSUSE e Raspberry Pi OS. Nenhum servidor entre o celular e o computador.

Instalar o MouseOS no Linux

  1. Baixe o .deb (Ubuntu, Debian, Mint; arm64 para o Raspberry Pi OS) ou o .rpm (Fedora, openSUSE) e instale com o seu gerenciador de pacotes. O pacote concede o uinput para o Wayland e inicia o MouseOS com a sua sessão.
  2. Abra o MouseOS, ou entre de novo na sessão. No Wayland sem o pacote (uma compilação sua), clique em PERMITIR O CONTROLO e digite sua senha uma vez (detalhes abaixo). No X11 não há nada a permitir.
  3. Abra o MouseOS no celular, na mesma rede. Clique em PERMITIR no computador para esse celular. Pronto.

Sem mouse no computador? Um Raspberry Pi por SSH

Nada acima exige um clique. Instale o pacote, reinicie (ou entre de novo na sessão): o MouseOS está rodando na sessão da área de trabalho. Depois, por SSH ou em qualquer terminal da máquina:

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

Esses comandos falam com o app em execução só a partir deste computador: nada na rede consegue alcançá-los. A partir do primeiro celular, o mouse é ele, inclusive para clicar em PERMITIR quando o próximo chegar.

X11 ou Wayland: como a entrada chega

SessãoComo a entrada chega
X11XTest: ponteiro, botões, os dois eixos de rolagem, digitação Unicode em qualquer layout.
WaylandUm mouse e um teclado virtuais via uinput, vistos pelo compositor como hardware real. PERMITIR O CONTROLO executa uma única etapa pkexec: ela adiciona uma regra udev que marca /dev/uinput com uaccess, ou seja, acesso só para o usuário logado, e carrega o módulo na inicialização.

Prefere fazer à mão? O app mostra os três comandos que executaria. O volume passa pelo PipeWire ou PulseAudio; as teclas de mídia chegam ao player que estiver em primeiro plano.

Portas e rede

  • Cliques, teclas e status: WebSocket na porta TCP 53317. Ponteiro e rolagem: UDP 53318, aceito só de um celular que você permitiu.
  • Descoberta: mDNS mais um beacon UDP, então não há IP para digitar. Se o seu firewall bloquear, abra essas duas portas para a sua rede local ou digite o endereço que o app mostra.
  • Nenhum servidor no meio. O que você faz nunca sai da sua rede.

Perguntas frequentes

Funciona no Wayland?

Sim. O Wayland não deixa os apps moverem o ponteiro, então o MouseOS usa um dispositivo de entrada virtual (uinput), como um mouse e um teclado de verdade. O pacote configura isso; uma versão compilada por você pede para clicar uma vez em PERMITIR O CONTROLO e digitar sua senha.

Quais distribuições?

Linux 64 bits, x86_64 e arm64: um .deb para Ubuntu, Debian, Mint e Raspberry Pi OS (Ubuntu 22.04, Mint 21, Debian 12 e posteriores), um .rpm para Fedora e openSUSE.

Posso usar o celular como mouse remoto no Ubuntu ou no Linux Mint?

Sim. Instale o .deb, abra o MouseOS no celular na mesma rede e permita esse celular uma vez no computador. Funciona no Ubuntu 22.04 e no Linux Mint 21 ou mais recentes, no X11 e no Wayland.

Funciona em um Raspberry Pi, ou em um computador sem mouse?

Sim. O .deb arm64 roda no Raspberry Pi OS 64 bits (Pi 4, 5, 400). O pacote inicia o MouseOS em cada sessão do desktop, e mouseos allow --next por SSH libera o primeiro celular, sem precisar de mouse no computador.

Quais portas ele usa?

TCP 53317 (WebSocket para cliques, teclas e status) e UDP 53318 (ponteiro e rolagem), só na rede local. A descoberta usa mDNS e um beacon UDP.

O MouseOS coleta o que eu faço?

Não. O que você faz com o mouse e o teclado nunca sai da sua rede. O app só envia estatísticas de uso anônimas, e você pode desativá-las.