Magic Switch: Apple Magicキーボード/トラックパッド/マウスを2台のMac間で共有する
Magic Switch: Share Apple Magic keyboard/track-pad/mouse between two Macs (joshua.hu)
要約
Magic Switchは、AppleのMagicキーボード、トラックパッド、マウスを2台のMac間で簡単に共有できる無料のオープンソースmacOSアプリです。従来、これらのデバイスは複数のMac間で切り替える際にUSBでの再ペアリングが必要でしたが、このアプリはそれを不要にし、シームレスな共有を実現します。セキュリティにも配慮されており、ペアリングコードによる安全な接続が可能です。
全文翻訳
Magic Switch: Magicキーボードとトラックパッドを2台のMac間で共有する(無料)
TL;DR: Magic Switchは、AppleのMagic Keyboard、Trackpad、またはMouseを2台のMac間で共有するための、無料のオープンソースmacOSアプリです。Apple IDやUSBでの再ペアリングの手間は一切不要です。GitHub上のソースコード。
最近、約7ヶ月ぶりに台湾からポーランドに帰国しました。そこでは…自転車に乗ったり、中国語を学んだり、人生で考えもしなかったような経験を積んだりしていました。帰国にあたり、もはや単なる観光客ではないことを認め、(賃貸の)アパートを少しでも素敵に見せようと決意しました。インテリアデザインは大好きですが、過去5年間住んでいるこの場所では、全体的な低コストにもかかわらず、定期的に使用したり必要としたりする必需品以外に投資する気になれませんでした。バックパック一つで生活することもできます。実際に数ヶ月単位でそうしてきました。ポーランドにはスーツケース半分の荷物で来ました。生活に必要なのは必需品だけです。私の持ち物のほとんどは価値のあるものではありません。しかし、それらに込められた感傷的な価値は、プライスレスなものにしています。私の部屋が素敵でなかったわけではありません。実際、Couchsurfingで私がホストした多くの人々は、私が部屋のデザイン、配置、アイテムの選択を気に入ってくれたとコメントしてくれました。それらはほとんど必需品でした。
ポーランドに戻ってから、アパート全体をリニューアルしています。台湾での経験は私に大きな影響を与えました。毎週か二週間に一度移動し、滞在した場所、探索した場所、訪れたギャラリー、スタジオ、美術館などがすべて私の心に響きました。私は根っからのミニマリストですが、人生の楽しみと利便性がついに私を打ち負かしました。おそらく、ただ年を取っただけかもしれません。もしすぐにここから追い出されたら、私は打ちのめされるでしょう。なぜなら、色が合うか、素材が適しているか、入手困難なデザインやアイテムを選んだ私の努力が、おそらく私が次に住む場所には合わないからです。キッチンの壁のタイルが違うかもしれませんし、家具の色合いも違うかもしれませんし、カーテンの色も違うかもしれません。腹立たしいことです。
人生で初めて、ちゃんとしたデスクを買うことにしました。普段はベッドの上か、どこか横になって作業しています。デスクに座るのは、私にとって一般的に苦痛な経験であり、それはずっと続いています。座っていること自体が非常に苦痛なのです。約5分後には、経験したことのないような激しい痙攣が背中に起こり始めます。
おそらくエーラス・ダンロス症候群を患っており、それが(私の極端な柔軟性など)他の症状と相まって、どの医師、外科医、理学療法士、あるいは「助けてくれる友人」も助けてくれなかった背中の痛みの問題につながっているのでしょう。その痛みがどのようなものかを感じた唯一の時は、オーウェルの『1984年』でした。
[…]彼の体は歪められ、関節はゆっくりと引き裂かれていった[…]
そこで、スタンディングデスクを購入しました!
[画像: 新しいスタンディングデスク:モニター、Magic Keyboard、Magic Trackpadが上にあり、自転車が下に停められている]
はい、今日のブログは物語と技術的な詳細が混在しています。お付き合いください、私たち皆、それぞれの悪魔を抱えています。
その他にもモニターを購入したので、キーボードも必要になりました。私は無料のオプションを選びました。Apple Magic KeyboardとMagic Trackpadです。これら2つはBluetoothデバイスで、初期ペアリングにはUSB-Cが必要です。
どうやらAppleは、「とにかく動く」という賢明さにもかかわらず、これらの周辺機器を一度に複数のデバイスに接続できないようにしたようです。複数のデバイスに同時に接続でき、使いたいときにいつでも簡単にデバイスを切り替えられるAppleのAirPodsとは異なり、Magic KeyboardとMagic Trackpadは複数のデバイスとのペアリングを拒否し、複数のコンピューターでの使用は非常に苦痛です。実際、それ以上にひどいのは、使用中のデバイスから周辺機器を切断して、別のデバイスに接続するだけではダメだということです。そうではなく、完全な再ペアリングを行うために、USB経由で別のデバイスに接続しなければならないのです。基本的に、これらの周辺機器は非常にくっつきやすいのです。
単一の周辺機器にペアリングされた2台のデバイスを持つことはできますが、その周辺機器が2台目のデバイスに接続されるようにするのは至難の業です。最初のデバイスをシャットダウンしたり、Bluetoothを切断したりしても、動作しません。これはよくある問題です。実際には、周辺機器をデバイス間で共有する実際の方法がありますが、それは両方のデバイスで同じAppleアカウントにサインインしている必要があります。設定 -> ディスプレイ -> 詳細設定 -> MacまたはiPadにリンク、と進むと機能する場合があります。しかし、これは私のユースケースには合いません。なぜなら、Appleアカウントにログインしたくない(そして場合によってはできない)からです。
blue-switch
Apple Storeで販売されている有料の製品があり、これがおそらく役立つと謳っています。私はblue-switchというオープンソースソフトウェアを見つけました。これは非常にシンプルなメニューバーUIを作成し、周辺機器を一方のシステムから切断し、もう一方に接続するために使用できました。基本的に、その仕組みは以下の通りでした。
- mDNSを使用し、2台のデバイスが接続をネゴシエートします。
- 両方のデバイスは、例えば「周辺機器AA:BB:CC..から切断」のような様々なコマンドを送受信できます。
- デバイスはその後、周辺機器への接続を強制します。
基本的に、これはMagicデバイスの設計を回避するハックであり、USBケーブルを使って再ペアリングしたり、Bluetooth設定をいじったりする代わりに、クリック一つで再ペアリングダンスが実行されるように強制するだけでした。
blue-switchの問題点は、非常にシンプルな概念実証に過ぎず、LAN上のあらゆるものを信頼し、UXはほとんど存在せず(エラー処理能力すらありませんでした)。Claudeが教えてくれたように、元のアプリは次のようなことをしていました。
- mDNS/Bonjourによる検出 — アプリを実行している2台のMacがローカルネットワーク上で互いを見つけ、ルーティング情報(ホスト+ポート)を交換します。
- 平文のTCP制御チャネル — 検出後、どちらかのMacがもう一方に
NWConnectionを開き、短い文字列コマンド(CONNECT_ALL、UNREGISTER_ALL、NOTIFICATION、SYNC_PERIPHERALS、HEALTH_CHECK、およびOP_SUCCESS/OP_FAILEDack)を送信します。 - コアとなるBluetoothトリック —
CONNECT_ALLを受信すると、MacはIOBluetoothを使用してMagic周辺機器を自身に強制ペアリング/接続します。UNREGISTER_ALLを受信すると、それらを解放します。 - 基本的なメニューバーUI — 登録済み周辺機器と相手のMacのリストを持つステータスアイテム、およびいくつかのタブを持つ設定ウィンドウ。
Claudeがいなければ、これがどのように機能するのか(コードを読んでmacOSのBluetoothグルーを理解しようと試みる以外に)知る方法はありませんでした。人々はこれらのLLMコーディングエージェントを奴隷のように扱いますが、明らかに、私はLLMの奴隷です。
とにかく、blue-switchはそれだけでした。認証、暗号化、相手のMacがどのデバイスであるかを知る手段、そして(時には完全に避けられないように見える)失敗時のリカバリがありませんでした。私のマスターに忠実に、Claudeと私は、より安全で回復力のあるアプリケーション、適切なUI/UX、そしてこれらのデバイスを「見失う」ことのないアルゴリズムを共同でコーディングしました。
Magic Switch: 無料の代替手段
私はそれをMagic Switchと名付けました。
ソースコードはGitHubで入手可能であり、GitHubランナーでビルドされた不変のビルドもあります。
セキュリティ
セキュリティに関しては、以下の採用しました。
- 相互認証された、2台のMac間で帯域外で共有される12文字のペアリングコードでキー付けされた密封チャネル。
- ペアリングコードを使用して、PBKDF2-HMAC-SHA256(600kイテレーション)でPSKを設定し、macOSキーチェーンに保存しました。
- ただ楽しむために、接続ごとのハンドシェイクもあります。各側が32バイトのナンスを送信し、両方のデバイスがHKDFで方向固有のセッションキーを派生させます。さらに楽しくするために、トランスクリプトに対するHMAC(およびサーバー対サーバー攻撃を回避するための
client/serverロールタグ付き)でキーの所有権を証明します。Claudeは親切にも、私が最初に考案した関数が定数時間安全ではないことを教えてくれました(まあ、どうでもいいですが、笑)。 - デバイス間のメッセージは、単調なカウンターナンスを持つChaCha20-Poly1305密封ボックスとしてフレーム化されており、リプレイ攻撃を防ぐことができます。
- 12文字のペアリングコードを使用しているため、60秒あたり5回の暗号化失敗でレート制限も行っています。この制限に達すると、デバイスを15分間ブロックします。
- 接続自体を強化しました。30秒のアイドル/5分間の合計予算、接続ごとの状態(競合しやすい共有
ConnectionManagerを終了)、およびIP正規化により、攻撃者がIPv4/IPv6を交互に使用して予算を倍増できないようにしました。
スパークルモーションへのコミットメント なぜ単純なLANのみの接続のために、相手クライアントに「このBluetoothデバイスに接続し、あのBluetoothデバイスから切断する」と伝えるだけのことに、これほど手間をかけたのか疑問に思うかもしれません。実際には、それは私が物事を学びたかったからです。そして楽しむためです。
ハンドオフの円滑化
実際の機能変更としては、アプリとハンドオフをよりスムーズにし、「とにかく動く」ようにするために、いくつかの新しい機能を追加しました。
- 周辺機器を要求するだけでなく、相手のデバイスに周辺機器を送信することも可能です。Bluetoothの状態に触れる前に、セキュアチャネル経由で相手のシステムにpingを送信し、実際にハンドオフを受け入れることを確認します(macOSの典型的な挙動として、TCPが開いているだけでは不十分です。システムが半スリープ状態の可能性があるため)。ハンドオフが途中で失敗した場合、周辺機器をローカルに再接続するため、周辺機器がどちらのシステムにも残されたままになることはありません。
- ペアリングフローは、他のmacOSシステム(AirPlayなど)のものと似ています。基本的に、一方のシステムで12文字のペアリングコードを生成し、それが両方のシステムに表示される共有フィンガープリントを生成して確認します。
- 最初に(認証前)相手のシステムと通信するために、各Macは初めて相手のキーフィンガープリントを見たときにそれをピン留めします。後で異なるフィンガープリントが表示された場合、それはドロップされ、「Identity Mismatch」として表示されます。これにより、異なるシステムになりすまそうとする(認証ではなく暗号化!)一種のなりすましも検出されます。
- 元のアプリは、ワンクリックであなたのすべての周辺機器を相手のデバイスに送信しました。私は、単一のデバイスを送受信/要求できるようにしました。
ペアリング
2台のMacのペアリングは、ほとんどのApple製品のペアリングと似ています。一方がコードを生成し、もう一方がそれを入力し、その後両方が一致するフィンガープリントを表示して確認します。
| [画像: セットアップ前のペアリングタブ] |
|---|
| セットアップ前のペアリングタブ:コードを生成するか、もう一方のMacが作成したコードを入力します |
| [画像: ペアリングコードの生成] | [画像: もう一方のMacでのペアリングコードの入力] |
|---|---|
| 一方のMacで12文字のコードを生成… | …もう一方のMacで入力します |
| [画像: ペアリング済み、一致するフィンガープリントが表示されている] |
|---|
| ペアリング後、両方のMacに一致するフィンガープリントが表示されます。不一致は問題があることを意味します |
スリープ、クラムシェルモード、その他の煩わしさ
スリープ、クラムシェルモード(蓋を閉じたままモニターに接続)、その他の面倒なネットワークの問題に対処しようとすると、本当の問題が発生します。いくつかの便利な設定可能な機能を作成しました。
- システムがスリープすると、周辺機器を1)もう一方のMac、または2)「世界」(つまり、ペアリングを解除して他に何も行わないこと)にハンドオフしようと試みます。
- これらのマジックデバイスは、無線がスリープすると「スタック」し、電源を入れ直すまで再接続されないことがよくあります。私は、スリープする前にこのMacにあったものをプログラムが監視し、それらが再び現れた(つまり、電源を入れ直した)瞬間に再接続するようにしました。ただし、もう一方のMacに問い合わせて、それを使用していないことを確認してから行います(これにより、2台のMacがデバイスを奪い合うのを防ぎます)。
周辺機器の所有者は誰か?
このハンドオフ処理のすべてにおいて、基本的に一つの質問があります。「現在、周辺機器の所有者は誰か?」これはアプリケーションのどこにも「保存」されておらず、代わりに「周辺機器を所有する」ことを、現在それに接続されているBluetooth接続があることと文字通り解釈し、アプリは毎回、次のいずれかでそれを解決します。
- ローカルでBluetoothに問い合わせる。
- 接続されている相手のシステムに、「今それを持っていますか?」と尋ねる。
そこから、周辺機器がどちらに渡されるかは、いくつかのケースに分けられます。
- Macをクリックする(すべて移動):このMacが何を持っているかを確認します。すべて持っている場合、送信者です。相手のシステムがそれらを受け取ることを確認するためにpingを送信し、ローカルでペアリングを解除し、相手のシステムにそれらを取得するように指示し、途中で失敗した場合はロールバックします。何も持っていない場合、受信者です。まず相手のMacに解放するように指示し、次にローカルで接続します。混在している場合(一部はこちら、一部はあちら)、プログラムはあなたが何を意味するのか推測するのをやめ、整理するように求めます。
- 単一の周辺機器をクリックする:ロジックは同じですが、単一のデバイスに関するものです。このMacにある場合は送信、このMacにない場合は要求。接続中の場合はクリックを無視します。
- 自動的に取り戻す(ドロップ、ウェイク、または電源サイクル後):これは、2台のMacがデバイスを奪い合う可能性がある、私が考案した面倒なエッジケースです。再接続する前に、プログラムは相手のMacが実際にそれを使用しているかどうかを尋ねます。使用している場合は、そのままにしておきます。使用していない場合(または応答がない場合)、取得を試みます。したがって、このパスは相手のMacに切断するように指示するのではなく、誰も持っていないものを拾うだけです。
一般的に、特に次の点に関して、さらにロジックがあります。
- どちらのシステムにも何も残らないようにします。ハンドオフが何らかの理由で失敗した場合、アプリは開始時の状態に戻ろうとします(つまり、切断したものに再接続します)。
- 「到達不能」は、各方向で異なる意味を持ちます。周辺機器を要求していて、相手のMacが応答しない場合、すでに解放されたと想定します(このアプリがインストールされているMacがネットワークから切断された場合、このアプリで自動的に行われるため、周辺機器を解放しています)そして取得します。アプリは、アクティブで応答しているMacから周辺機器を強制的に引き離そうとはしません。
UI
UIについては、より洗練された表示とメニューバーのポップダウンを作成しました。
| [画像: Magic Switchメニューバーポップダウン] |
|---|
| メニューバーポップダウン:Macをクリックしてすべて移動するか、単一の周辺機器をクリックしてその一つだけを移動します。チェックマークは、それがこのMac上にあることを意味します |
- ポップダウンメニューに使用されるアイコンは、状況に応じて異なります。Bluetoothがオフまたはどの周辺機器にもペアリングされていない場合は三角形。システムが周辺機器を送受信している場合は、上/下の転送矢印。
- ポップダウンメニューでは、単一の周辺機器、または「すべて」を送受信できます。
- 24時間ごとにアップデートをチェックします(チェックが成功するまで、1時間ごとにローリングチェックが行われます)。自動更新は行いません。
メニューの後ろには、各ジョブにタブがある小さな設定ウィンドウがあります。
| [画像: 周辺機器設定タブ] | [画像: デバイス設定タブ] |
|---|---|
| 周辺機器タブ:Magicデバイスを登録し、返却するか、管理を停止します | デバイスタブ:相手のMacにpingを送信し、周辺機器を共有するか、忘れます |
| [画像: その他の設定タブ] |
|---|
| その他タブ:ログイン時に起動、ライセンス情報、および手動アップデートチェック |
メニューバーのポップダウンメニューは、私が望むように機能させるのが最も難しい部分でした。以下の要件がありました。
- ポップダウンメニューを開いたときに、画面上のどこかにマウスを移動してもメニューは最小化されない(つまり、メニューを閉じる唯一の方法は何かを押すこと)。
- ポップダウンメニューが開いているときにマウスを移動しても、アプリケーションのフルスクリーンモードではメニューバーが消えない。
- すべてのボタンと重要なテキストには、役立つホバー/ツールチップヒントが必要です。
- ポップダウンメニューから設定を開くと、デスクトップに開き、自動的にその画面に移動する必要があります。
- Cmd-Q(終了)を押してもアプリケーションは終了せず、設定(または設定メニュー)のみが閉じます。
- ポップダウンメニューは、情報に変更があった場合、たとえ開いていても自動的に更新する必要があります。
- すべてのアイコンは、1ピクセルもずれることなく、論理的で区切られた方法で配置される必要があります。
おそらく誰もこれを使用しないでしょう。私は間違いなくお勧めしません!それにもかかわらず、作るのがかなり楽しかったです。