動作#

ジェスチャーを選び、動作でその実行内容を選択します。エディターは 8 種類の動作を用意しています。ほとんどの作業は単純な動作で足ります。条件分岐や複数の操作が必要な場合は Lua を使ってください。

キーを送る#

キー列を入力するか、記録をクリックしてショートカットを押し、完了をクリックします。たとえば Windows では ^c がコピー、Mac では #c がコピーです。構文ヘルプで構文ガイドを開けます。

先にカーソル下のウィンドウを前面にしてから送るをオンにすると、先にジェスチャーの対象をアクティブにします。オフのままでは、ショートカットはキーボード入力を受け取っているアプリに送られます。対象は環境設定 → ジェスチャの対象にも従います。このエディターにはプレーンテキストの切り替えはなく、テキスト優先モードは Lua 経由で使えます。

ウィンドウ操作#

1 つの操作を選びます。ジェスチャーの対象に適用されます。

操作	動作内容
最小化	ウィンドウを最小化します。
最大化 / 元に戻す	最大化と元のサイズを切り替えます。
閉じる	ウィンドウに終了を要求します。
常に手前 / 解除	Windows では最前面を切り替えます。Mac のエディターでは非対応のため無効です。

Mac のウィンドウ操作はアクセシビリティを使います。最大化 / 元に戻すはアプリのズームボタンを押すため、結果のサイズはそのアプリの挙動に従い、ネイティブのフルスクリーンは要求せず、最小化済みのウィンドウはスキップします。アプリによって公開されるウィンドウ操作は異なります。

アプリを開く#

アプリには Windows の実行ファイルを指定します。参照…で選択できます。Mac では com.apple.Safari のようなバンドル ID、.app のパス、実行ファイルのパスを使います。引数は省略できます。Mac では引数は引用符を処理して分割されるため、コマンドライン実行ファイルには完全なパスを使ってください。

すでに起動しているときは切り替えるかもう一枚開くを選べます。Windows では管理者として実行も選べます。Mac は権限の昇格やウィンドウ条件付き起動に対応していません。現在の動作エディターにクラス／タイトル／正規表現の欄はありません。

URL を開く#

URLを入力し、必要ならブラウザーも指定します。ブラウザーを空欄にすると既定のブラウザーを使います。Windows はブラウザーの実行ファイル、Mac はブラウザーのバンドル ID かアプリのパスを受け付けます。挿入ボタンは、選択テキスト、クリップボードのテキスト、アプリ名、プロセス ID、ウィンドウタイトルのプレースホルダーを追加します。

選択したテキストでウェブ検索するには、URL を次に設定します。

https://www.google.com/search?q=%MS_SELECTED_TEXT%

アプリケーションでテキストを選択してからジェスチャーを実行してください。選択テキストは URL エンコードされます。すでに http://、https://、www. で始まっている場合、Mousetroke はそのアドレスを直接開きます。www. には https:// が付きます。

コマンドを実行#

テキスト欄にコマンドを入力します。挿入は変数を追加します。Windows は非表示の cmd.exe /C で実行し、Mac は /bin/zsh -c を使います。これはシェルの構文なので、引数は正しく引用符で囲んでください。置換されたテキストはシェルエスケープされないため、信頼できない選択テキストをコマンドに渡さないでください。

たとえば、次の Windows コマンドはタスクマネージャーを開きます。

taskmgr.exe

Mac では代わりにアプリを開くで com.apple.ActivityMonitor を指定します。

メディアとシステム#

エディターは再生 / 一時停止、次のトラック、前のトラック、音量を上げる、音量を下げる、ミュート、明るさを上げる、明るさを下げるを用意しています。

Windows の明るさは、WMI フォールバック付きの DDC/CI で 10 パーセントポイント調整します。Mac の明るさは内蔵画面に明るさキーを送ります。外付け DDC/CI には対応していません。Lua の明るさ関数は Mac で使えませんが、これらの Mac のシステム動作は使えます。画面の隅と端を参照してください。

メニューを表示#

+ メニュー項目を追加をクリックし、メニュー項目名を入力して、各項目の中の動作を選びます。上へ、下へ、メニュー項目を削除で整理します。メニューはジェスチャーの位置に表示されます。エディターに列数の欄はなく、項目の中に別のメニュー種別もありません。Mac は 1 列のみで、複数列の設定は非対応として表示されます。

Lua スクリプト#

ms_action を定義する完全なスクリプトを貼り付けます。エディターは Lua 入門、API リファレンス、使用例へのリンクを表示します。テキスト欄では Tab は 2 スペースとして入力されます。

変数#

これらのプレースホルダーは URL を開く → URL、コマンドを実行、アプリを開く → アプリ／引数で使えます。キー送信の文字列、Lua のソース、メニュー名、ブラウザーでは展開されません。

変数	値
`%MS_SELECTED_TEXT%`	動作に必要なときに取得された選択テキスト。取得できない場合は空。
`%MS_CLIPBOARD_TEXT%`	現在のクリップボードのテキスト。要求時に取得されます。
`%MS_PID%`	対象のプロセス ID。
`%MS_EXE%`	対象の実行ファイル識別情報。Windows はパス、Mac はバンドル ID か実行ファイルのパス。
`%MS_APP_NAME%`	識別情報のファイル名部分。Mac ではバンドル ID のことがあります。
`%MS_WID%`	プラットフォームのウィンドウ ID（10 進数の文字列）。
`%MS_WIN_NAME%`	対象のウィンドウタイトル。Mac は必要時にアクセシビリティ経由で取得します。
`%MS_MOUSE_X%`, `%MS_MOUSE_Y%`	ジェスチャー開始時の画面座標。
`%MS_MOUSE_Y_FLIP%`	仮想画面の下端座標からジェスチャー開始時の Y 座標を引いた値。
`%MS_TARGET_MODE%`	対象の設定に応じた `UnderCursor` または `Focused`。

対象を取得できない場合、一部の変数は存在しないことがあり、不明なプレースホルダーはそのまま残ります。URL テンプレートで自動的に URL エンコードされるのは選択テキストだけで、他の置換はそのまま挿入されます。Lua ではプレースホルダーではなくエントリー引数と ms 関数を使ってください。

動作#