機能ガイド

このページでは、FairyOperator に搭載されているすべての機能（妖精）について、できることや設定項目、ホットキー、必要な権限をまとめて紹介します。

前提条件

FairyOperator を利用する前に、以下の環境と権限を確認してください。

できること

• キーボードデバイスごとに独立したマッピングプロファイルを作成・保存できます。
• 通常キー同士のリマップ（CGEvent タップを使用）に対応しています。
• 修飾キー同士のリマップ（例: CapsLock を Control に変更）にも対応しています。
• CapsLock を通常キーに割り当てることもできます。
• HID-only キー（通常のイベントには現れない特殊キー）もリマップできます。
• 未接続のキーボードに対するプロファイルも保持され、再接続すると自動的に復元されます。
• 最後に押されたキーコードを設定画面でリアルタイムに確認できます。

設定項目

• 機能全体の有効／無効トグル。
• キーボード一覧。接続中・未接続を区別して表示し、右クリックでプロファイルを削除できます。
• マッピングエディタ。「変更前のキー → 変更後のキー」の組み合わせを追加・編集し、ペアごとに有効／無効を切り替えられます。プロファイル名の変更も可能です。

必要な権限

アクセシビリティと入力モニタリングが必要です。

使用例

• 日本語キーボードの「英数」「かな」キーを、Escape など別のキーに割り当てて活用する。
• CapsLock を Control に変更して、エディタ操作を快適にする。

できること

• 最近使用順に並んだアプリ一覧を、最大 7 列のグリッドで表示します。
• ホットキーを押し続けて前後に選択を移動し、キーを離した瞬間に確定します。
• Escape キーでキャンセル、マウスホバーとクリックでも選択・確定が可能です。
• 右クリックでウインドウピッカーを開き、サムネイル付きで複数ウインドウから選択できます。
• 最小化されているウインドウを自動で復元します。
• Unity Editor を切り替える際は、プロジェクト固有のアイコンを自動的に表示します。
• 使用順は再起動後も保持されます。

設定項目

• 機能全体の有効／無効トグル。
• 「進む」「戻る」のキーバインド。

ホットキー

必要な権限

アクセシビリティ（最小化ウインドウの復元など）と画面収録（サムネイル表示）が必要です。

使用例

• Cmd+Tab よりも少ない手数でアプリを切り替える。
• 複数のウインドウを持つアプリで、特定のウインドウを直接選んで切り替える。

できること

• 0.5 秒間隔でクリップボードの変化を監視し、変更があれば履歴に追加します。
• テキストと画像（PNG・TIFF）の両方を保存できます。
• パスワードマネージャーなどが付与する機密タイプ（org.nspasteboard.ConcealedType）は自動的に保存対象から除外します。
• ピン留め機能でアイテムを先頭に固定でき、自動削除の対象から外せます。
• インクリメンタル検索で履歴を素早く絞り込めます。
• 数字キー 1〜9 を押すと、対応する番号のアイテムを直接選択できます。
• 選択を確定すると、もとのアプリに自動で戻り、⌘V を送出して貼り付けます。
• 使用したアイテムは履歴の先頭（ピン留めアイテムの直後）に自動で並び替えられます。

設定項目

• 機能全体の有効／無効トグル。
• 呼び出しホットキー（デフォルト: ⌃V）。
• 検索ホットキー（デフォルト: ⌘F）。
• 最大保存件数（20 / 50 / 100 / 200 から選択。デフォルトは 50）。
• 履歴をクリアするボタン。

パネル内のキー操作

必要な権限

アクセシビリティが必要です（⌘V を送出するため）。

できること

• ウインドウを左半分・右半分・上半分・下半分・最大化のいずれかに配置できます。
• サイズ比率を維持したまま、別のスクリーンへ移動できます。
• マルチモニター環境では、ウインドウが現在表示されているスクリーンを自動で判定します。

ホットキー（デフォルト）

必要な権限

アクセシビリティが必要です。

使用例

• マウスでドラッグせずに、キーボードだけで素早く左右分割の配置にする。
• 外部モニターと内蔵モニターの間で、ウインドウを瞬時に移動する。

できること

• 複数のルールを登録し、自由に並べ替えや削除ができます。
• ルールごとに有効／無効を切り替えられます。
• 修飾キーを組み合わせたトリガーキーを設定できます。
• アクションは「直接入力に切り替え」「日本語入力に切り替え」「トグル」の 3 種類から選べます。
• 「通過」を有効にすると、トリガーキー本来の動作も同時に実行されます。たとえば Escape キーで IME を切り替えつつ、Escape の本来の動作も維持できます。
• 対象アプリを bundleID で絞り込めます。指定が空の場合はすべてのアプリで動作します。

設定項目

• 機能全体の有効／無効トグル。
• IME ルールの一覧。各ルールについて以下を設定できます。
  • トリガーキー（「変更」ボタンを押してキャプチャします）。
  • アクションの選択。
  • 「通過」のチェックボックス。
  • 対象アプリ（実行中アプリから追加でき、バッジ表示で削除できます）。

デフォルトのルール

必要な権限

アクセシビリティが必要です。

使用例

• Vim 系エディタで Insert モードを抜けると同時に、英数入力に自動で切り替える。
• 特定のアプリでだけ Escape キーを「IME を OFF にするキー」として動作させる。

できること

• メニューバーに常にトグル用の矢印アイコン（◀／▶）を表示します。
• トグルを ON にすると、アプリメニューを空のメニューに差し替え、ステータスアイコンの表示領域を確保します。
• トグルを OFF にすると、もとのメインメニューを復元し、直前のアプリにフォーカスを戻します。
• FairyOperator からフォーカスが離れると、メニューは自動的にもとの状態に戻ります。
• ホットキーからもトグル操作が行えます。

設定項目

• 機能全体の有効／無効トグル。
• 現在の状態表示（「開き」または「閉じ」）。
• トグル用ホットキー（デフォルト: ⌃⌥M）。

必要な権限

アクセシビリティが必要です。

使用例

• ステータスアイコンが多くて隠れてしまっているとき、アプリメニューを一時的に消してすべて表示する。

できること

• ウインドウ数バッジ　2 つ以上のウインドウを持つアプリのアイコン上に、ウインドウ数のバッジを表示します。
• 重複アプリの識別ドット　同名のアプリを複数起動している場合、それぞれのインスタンスを 8 色のドットで区別して表示します。
• Unity プロジェクト名　Unity Editor のアイコン上に、現在開いているプロジェクト名を表示します。
• 応答なし表示　応答が止まっているアプリにオレンジの砂時計アイコンを表示します。
• Dock アイコンをクリックまたはホバーすると、サムネイル付きのウインドウピッカーをポップオーバーで表示します。
• ウインドウピッカーから直接ウインドウを選択して、最前面に表示できます。
• マルチモニター環境で Dock が別のスクリーンに移動した場合も、オーバーレイが追従します。

設定項目

• 機能全体の有効／無効トグル。

必要な権限

アクセシビリティと画面収録（サムネイル取得時）が必要です。

使用例

• 同じアプリを複数インスタンス起動している際に、Dock 上でそれぞれを識別する。
• 多数のウインドウを持つアプリで、Dock から目的のウインドウへ直接切り替える。
• 応答が止まったアプリを Dock 上ですぐに把握する。

抑止モード

できること

• ホットキーから抑止状態をトグルできます。
• メニューバーアイコンのメニューにある「スリープしない」項目からもトグルできます。
• アプリ終了時に IOPMAssertion の解放と pmset の復元を必ず実行します。
• 「蓋を閉じても継続」モードで管理者パスワードの入力をキャンセルした場合は、自動的に OFF へ戻します。

設定項目

• 機能全体の有効／無効トグル。現在の状態（「抑止中」または「停止」）を表示します。
• 抑止対象モードの選択。
• トグル用ホットキー（デフォルトでは未設定です）。

設定項目

• 「ログイン時に起動」トグル。macOS のログイン項目に FairyOperator を登録します。
• 現在のバージョンを表示します。

メニューバーアイコンの操作

メニューバー上のアイコンには、以下のクリック操作が割り当てられています。

表示されるメニュー項目は、バージョン情報、設定…（⌘,）、スリープしない（トグル）、終了（Q）です。

設定ファイルとログ

FairyOperator が使用するファイルの一覧です。設定の引っ越しや、トラブルシューティング時に参照してください。