ドキュメント

設定ウインドウの構成と、全体を通して使っている用語について。

はじめに

MouseTuner はメニューバーアプリです。Dock アイコンもメインウインドウもありません。完全な画面は設定ウインドウだけで、メニューバーのアイコンから開きます。

権限

スムーススクロール、Button Mapping、Domain Rule（アクティブなブラウザタブの URL の読み取り）にはアクセシビリティが必要です。許可がない場合は、該当するパネルが何が足りないかを説明し、システム設定へのリンクを表示します。

入力監視は必要ありません。HID++ はベンダー独自のインターフェイスと Bluetooth GATT を通りますが、どちらも入力監視の管轄外だからです。Bluetooth で直接つないだ Logitech のマウスでは Bluetooth のペアリング確認がもう 1 回表示され、許可を反映するには再起動が必要です。

設定パネル

スクロール — Scroll Curve のエディタとリアルタイムプレビュー。
ボタン — Trigger から Action への割り当て。
App Override — Scroll Curve と Button Mapping の両方を上書きできるアプリを 1 つのリストで管理します。
デバイス — Recognized Device の DPI、SmartShift、バッテリー、コントロールテーブル。
入力ソース — アプリまたはブラウザのドメインによる入力ソースの自動切り替え。
一般 — アップデート、iCloud 同期、クラッシュレポート（既定でオフ）。
権限 — 何が許可されていて、何が足りず、それがなぜ効いてくるのか。

用語

これらの用語は、このドキュメントを含め、MouseTuner が対応するすべての言語で英語のまま使います。

Trigger: マッピングを発火させる条件です。クリック、ダブルクリック、長押し、上下左右いずれかのドラッグ、Chord、Hold + Scroll があります。
Chord: 2 つのボタンを同時に押し下げている状態です。
Action: マッピングが実行する内容です。キーボードショートカット、システム操作、メディアキー、アプリや URL を開く、AppleScript、シェルコマンド、Modifier Hold のいずれかです。
Modifier Hold: ボタンを押した瞬間に修飾キーを押し、離した瞬間に離す Action です。押している間だけ話す音声入力のためにあります。
Trajectory Gesture: ボタンを押しながら方向を順に描いてアクションを発火させる仕組みです。計画中で、まだ実装されていません。
App Override: 特定のアプリが最前面にある間だけ、グローバルの設定を置き換える Scroll Curve または Button Mapping です。
Scroll Curve: スムーススクロールの挙動を決めるパラメータ一式です。最小ステップ、速度ゲイン、継続時間、減衰から成ります。
SmartShift: ラチェット式ホイールとフリースピンを自動で切り替える Logitech の機能です。HID++ 経由で制御します。
Device Profile: 認識済みのモデルで何ができるかを記述したものです。ボタン構成、DPI の範囲、SmartShift への対応、バッテリー残量の読み取り方法を含みます。
Recognized Device: Device Profile があるマウスです。これがあると追加のハードウェア制御が使えるようになります。
Generic Device: それ以外のマウスで、Universal HID Layer 経由で扱います。スムーススクロールと基本的な Button Mapping は問題なく動きます。
HID++: Logitech 独自のデバイスプロトコルです。DPI、SmartShift、バッテリー残量はすべてこれを通ります。
License Key: 購入後に受け取る文字列です。1 回の購入につき 1 つ発行されます。
Seat: 1 つの License Key を紐づけられるマシンのことです。キーごとに 3 台までです。
Credential: アクティベート時に発行され、そのマシンに紐づきます。買い切りなので、有効期限は持ちません。
Machine Fingerprint: ローカルの安定した識別子から作るハッシュです。その元になる値が Mac の外に出ることはありません。
Trial: 全機能を 30 日間使えます。アカウントも支払い方法も要りません。
Grace: Credential の確認に失敗しても App が動き続ける期間です。14 日間です。
Revocation: 返金やチャージバックの後にキーを無効として記録することです。App は次の 1 日 1 回の確認で機能を落とします。
Blind Test: リリースの判断基準です。5〜10 人が、どちらのビルドか知らされないままスクロールの感触を比べます。
Command: macOS の修飾キーである Command キーのことです。キー名はマッピングでもショートカットでも英語のまま表示します。
Option: macOS の修飾キーである Option キーのことです。扱いは上と同じです。