ガイド · Linux · X11 · Wayland

Linux用リモートマウス:スマホで操作、Waylandにも対応

多くのスマホマウスアプリはX11止まりです。MouseOSはWayland上のGNOMEとKDE Plasmaも操作できます:トラックパッド、キーボード、画面表示、コピー&ペースト、メディアキーを、スマホからネットワーク経由で。

要点:.debまたは.rpmをインストールし、スマホでMouseOSを開いて、「許可」を一度クリックするだけ。無料で、X11でもWaylandでも動きます。Ubuntu、Debian、Mint、Fedora、openSUSE、Raspberry Pi OSに対応。スマホとパソコンの間にサーバーはありません。

Linux に MouseOS をインストールする

  1. .deb(Ubuntu、Debian、Mint。Raspberry Pi OSにはarm64)または.rpm(Fedora、openSUSE)をダウンロードし、パッケージマネージャでインストールします。パッケージがWayland用のuinputを許可し、デスクトップセッションと一緒にMouseOSを起動します。
  2. MouseOSを開くか、ログインし直します。パッケージを使わないWayland(自分でビルドした場合)では、「操作を許可」をクリックしてパスワードを一度入力します(詳細は下記)。X11では許可は不要です。
  3. 同じネットワークで、スマホのMouseOSを開きます。パソコンでそのスマホに対して「許可」をクリック。完了です。

パソコンにマウスがない? SSHで使うRaspberry Pi

ここまでクリックは一度も要りません。パッケージをインストールして再起動(またはログインし直す)すれば、MouseOSはデスクトップセッションで動いています。あとはSSHか、そのマシン上の任意のターミナルから:

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

これらのコマンドは、このパソコンからのみ実行中のアプリとやりとりします。ネットワーク側からは届きません。最初のスマホをつないだあとは、そのスマホがマウスです。次のスマホの「許可」ボタンもそれで押せます。

X11 と Wayland:入力が届くしくみ

セッション入力の仕組み
X11XTest:ポインター、ボタン、縦横のスクロール、どのキー配列でもUnicode入力。
Waylanduinputによる仮想マウスとキーボード。コンポジタからは実際のハードウェアのように見えます。「操作を許可」はpkexecのステップを一度だけ実行します。/dev/uinputにuaccessタグを付けるudevルールを追加し(ログイン中のユーザーだけがアクセス可能)、起動時にモジュールを読み込むようにします。

手動で設定したい場合は、アプリが実行する3つのコマンドを表示します。音量はPipeWireまたはPulseAudio経由、メディアキーは手前のプレーヤーに届きます。

ポートとネットワーク

  • クリック、キー入力、状態:TCP 53317のWebSocket。ポインタとスクロール:UDP 53318、許可したスマホからのみ受け付けます。
  • 検出:mDNSとUDPビーコンを使うので、IPアドレスの入力は不要です。ファイアウォールに遮られる場合は、この2つのポートをLAN向けに開けるか、アプリに表示されるアドレスを入力してください。
  • 間にサーバーはありません。操作内容がネットワークの外に出ることはありません。

よくある質問

Waylandで動きますか?

はい。Waylandではアプリがポインターを動かせないため、MouseOSは本物のマウスやキーボードと同じ仮想入力デバイス(uinput)を使います。パッケージが設定します。自分でビルドした場合は、「操作を許可」を一度クリックしてパスワードを入力します。

どのディストリビューションで使えますか?

64ビットのLinux、x86_64とarm64:Ubuntu、Debian、Mint、Raspberry Pi OS用の.deb(Ubuntu 22.04、Mint 21、Debian 12以降)、FedoraとopenSUSE用の.rpm。

UbuntuやLinux Mintでスマホをリモートマウスにできますか?

はい。.debをインストールし、同じネットワークでスマホのMouseOSを開いて、パソコンでそのスマホを一度だけ許可します。Ubuntu 22.04、Linux Mint 21以降のX11とWaylandで使えます。

Raspberry Piや、マウスのないパソコンでも動きますか?

はい。arm64の.debはRaspberry Pi OS 64ビット(Pi 4、5、400)で動きます。パッケージがデスクトップのセッションごとにMouseOSを起動し、SSHでmouseos allow --nextを実行すれば最初のスマホを受け入れます。パソコンにマウスは不要です。

どのポートを使いますか?

TCP 53317(クリック、キー入力、状態のためのWebSocket)とUDP 53318(ポインタとスクロール)。ローカルネットワークのみ。検出にはmDNSとUDPビーコンを使います。

MouseOSは私の操作を収集しますか?

いいえ。マウスやキーボードの操作がネットワークの外に出ることはありません。アプリが送るのは匿名の利用統計だけで、オフにもできます。