MonoFlick Companion for Mac でできること

MonoFlick Companion は、iPhone で打った文字や操作を Mac で「実際のキー入力／マウス操作」として再現する常駐アプリです。 Dock には表示されず、メニューバー右上のアイコンから常にアクセスできます。

• 表示名: MonoFlick Companion
• UI 形態: メニューバー常駐（LSUIElement、Dock 非表示）
• 対応 OS: macOS 15 (Sequoia) 以降
• サンドボックス: OFF（アクセシビリティ権限と整合させるため、Mac App Store ではなく直接配布）

メニューバーポップオーバーの構成

メニューバーのアイコン(iphone)をクリックすると、320pt 幅のポップオーバーが開きます。 ここから現在の接続状態、ペアリング PIN、各種ウィンドウへの導線がすべて確認できます。

• ヘッダー: アプリ名と ロゴ
• 接続状態: 色付きドット + 「MPC」「BLE」バッジで経路ごとの状態を表示
• エラーが 1 件以上ある場合のみ: 「エラー一覧」セクションが赤字で出現（件数表示 + 「開く」）
• ペアリング待機中のみ: 6 桁の PIN 大表示 + 「PIN を再生成」ボタン
• Accessibility 権限の状態 + システム設定への誘導
• Keystroke Visualizer ウィンドウへの「開く」ボタン
• よくある質問: ボタン押下で 既定ブラウザで FAQ ページを開きます（Web 提供）
• フッター: 環境設定 / このアプリについて / 終了

ウィンドウ一覧

起動時はすべて閉じた状態で、メニューバーから明示的に開きます。よくある質問は Web に移設したため、ローカルウィンドウはありません。

表示言語

システム言語に追従する 「システム」 がデフォルト。手動で日本語 / 英語を選ぶこともでき、切替は即時反映されます（一部のウィンドウタイトルは英語固定）。

セキュリティ系トグル（既定はすべてセキュア寄り）

アクセシビリティ Onboarding の再表示

初回起動時のアクセシビリティ案内をもう一度見たい場合に押す再表示ボタンを用意しています。あわせて、復旧手順として TCC データベースから本アプリのレコードのみを消す「アクセシビリティ権限をリセット」ボタンも用意しています。

接続まわりの設定

MPC（Wi-Fi）と BLE の有効化、同時接続数の制限、そして接続が不安定になったときの復旧手順を 1 か所にまとめています。

• Wi-Fi 経由の接続（MPC）を有効化 / Bluetooth 経由の接続（BLE）を有効化（既定はどちらも ON）
• 同時接続数を制限（既定 OFF、ON にすると 1〜8 台で上限指定）
• Bluetooth サービスを再起動 / Bluetooth 権限をリセット
• Bonjour サービス（mDNSResponder）を再起動 / DNS キャッシュをクリア

メンテナンス

MonoFlick Companion を再起動ボタンで、アプリ自身を終了して再起動します。接続中の iPhone / iPad は一時的に切断され、再起動後に自動で再接続されます（ペアリング情報は Keychain に保存されるため再ペアリング不要）。bluetoothd 再起動後の BLE 状態リセットや、アクセシビリティ権限の再要求にも使えます。

2 つの経路が並走

• MPC（Wi-Fi / AWDL）: 屋内・Wi-Fi がある環境で利用。低遅延・高スループット
• BLE + L2CAP CoC: 屋外・Wi-Fi OFF の環境で利用（有料機能）
• 先に確立した方が active になり、両経路を切替なく使えます

スリープ復帰時の自動再接続

Mac がスリープしたとき、コンパニオンは自動的に MPC / BLE の advertise を停止し、 起床時に 1 秒の待機を挟んで再開します。 iPhone 側の操作は不要で、ペアリング済みの状態は維持されます。

必要な権限

通信の安全性

• MPC は セッション暗号化（required）で常時暗号化
• BLE は AEAD（認証付き暗号）で 1 メッセージごとに seal / open
• 鍵交換は Curve25519 ECDH + HKDF、共有秘密は Mac のキーチェーンに保存
• サーバ経由しない 2 点間通信。インターネット越しの通信は一切ありません

受信メッセージの防御

• 未認証 peer からの注入メッセージは拒否
• ⌘Q など 危険ショートカットの deny-list（既定 ON）
• insert 受信長 / バックスペース回数 / ポインタ移動量に 絶対値上限
• 任意パスのバイナリ起動・任意引数は 厳格モードで拒否（既定 ON）
• ログに残るテキストは マスク表示（既定 ON、生表示への切替も可）

プライバシー

• 解析 SDK・広告 SDK・クラッシュレポート SDK のいずれも導入していません
• 外部サーバとの通信は 一切なし

必要環境

• macOS 15 (Sequoia) 以降
• iPhone 側: iOS 18 以降 の MonoFlick アプリ
• 初回ペアリングは Wi-Fi 環境を推奨（屋外オンリーでも BLE で初回 PIN 入力可能）

配布方法

• DMG での直接配布（Mac App Store ではありません）
• ad-hoc 署名（Sign to Run Locally）で個人配布
• 初回起動時は Gatekeeper の警告が出る場合があります → 右クリック「開く」で許可