キーボードショートカット・トレイ操作・配列切り替え・設定ファイル・ログのリファレンス
awase は「IME の状態」と「エンジンの状態」の組み合わせで動作を切り替えます。
| IME | エンジン | 動作 |
|---|---|---|
| ON | ON | 親指シフト（NICOLA）入力 |
| ON | OFF | 通常 IME 入力（ローマ字変換） |
| OFF | どちらでも | 英字直接入力（エンジンは自動停止） |
IME が OFF のときはエンジンが自動的に停止するため、パスワード欄などでも誤動作しません。
同梱のデフォルト配列（JIS版 layout/nicola.yab / US版 layout/nicola_us.yab）が、どのキーでどの文字を出力するかの一覧です。通常面は単独打鍵、他の3面は無変換・変換キー（親指シフト）または小指シフトキーとの同時打鍵で入力します。
配列は自由にカスタマイズできます。設定画面の「配列編集」タブで直接編集するか、独自の .yab ファイルを作成して切り替えられます（レイアウトの切り替え参照）。
デフォルト設定でのショートカット一覧です。config.toml で変更できます。
| カテゴリ | キー | 動作 |
|---|---|---|
| IME | Ctrl + 変換 | IME を ON にする。既に ON の場合はひらがな・ローマ字・CapsLock OFF へリセットする |
| IME | Ctrl + 無変換 | IME を OFF にする（冪等 — 既に OFF なら何も起きない） |
| IME | 左 Shift 単独タップ | 「IME-ON 半角英数」持続トグル。他のキーを介さず押して離すと切替、もう一度タップで解除（現状 MS-IME のみ対応。GJI は今後対応予定） |
| エンジン | Ctrl + Shift + 変換 | NICOLA エンジンを ON にする（親指シフト入力を有効化） |
| エンジン | Ctrl + Shift + 無変換 | NICOLA エンジンを OFF にする（ローマ字入力に切り替え） |
| エンジン | Ctrl + Shift + F12 | エンジンの ON/OFF をトグル（グローバルホットキー、config.toml で変更可） |
| システム | Ctrl + Shift + F11 | 現在のウィンドウのフォーカス判定を強制上書き（テキスト入力 ↔ バイパスを切替） |
| 親指シフト | 変換 | 右親指シフトキー（エンジン ON 中、他のキーと同時押しで NICOLA 判定） |
| 親指シフト | 無変換 | 左親指シフトキー（エンジン ON 中、他のキーと同時押しで NICOLA 判定） |
| IME | 半角/全角 | IME の ON/OFF をトグル（Windows 標準の動作） |
| 緊急 | 無変換 × 3（400ms 以内） | NICOLA エンジンを強制 OFF（Ctrl スタック等でショートカットが効かないとき） |
| 緊急 | Ctrl+無変換 → Ctrl+変換 → Ctrl+無変換（2秒以内） | パニックリセット — 標準状態（IME ON・ひらがな・エンジン ON）へ強制復帰 |
冪等な IME 制御について： Ctrl+変換 は「IME を ON にする」という操作です。従来のトグル方式と異なり、現在の状態がずれていても必ず意図した結果になります。 エンジン ON/OFF とは独立して動作します。IME が既に ON の場合は、入力途中の状態（カタカナ・半角英数など）をひらがな・ローマ字・CapsLock OFF へ揃えて再確定させます。
「IME-ON 半角英数」トグルについて： 左 Shift 単独タップは、IME を開いたまま NICOLA エンジンだけを一時的に停止し、英数字を直接入力できるようにします（IME 自体は閉じないため、パスワード欄などとは異なる仕組みです）。もう一度左 Shift を単独タップすると通常のかな入力へ戻ります。右 Shift の単独タップやフォーカス変更でも自動的に解除されます。
タスクバー右端のシステムトレイに awase アイコンが常駐します。
layouts_dir 内の .yab ファイルを一覧表示。選択するとレイアウトが即座に切り替わりますトレイアイコン右クリック → 「設定...」で開きます。変更後は「適用」ボタンで保存・即時反映されます。
| 項目 | 説明 |
|---|---|
| キーボードモデル | JIS（日本語配列）または US（英語配列）を選択 |
| 同時打鍵閾値 | 同時打鍵と判定する時間幅（ms）。NICOLA 規格標準は 100ms |
| 出力モード | Unicode（推奨）・PerKey・Batched。通常は Unicode のまま |
| フックモード | Relay（推奨・安定）または Filter（低遅延） |
| 自動起動 | Windows ログオン時に自動起動するかどうか |
| レイアウト | 使用する .yab 配列ファイルの選択。「再スキャン」で一覧を更新 |
確定モード（confirm_mode）と投機出力待機（speculative_delay_ms）は設定画面から撤去しました。ほとんどのユーザーは既定の wait のまま使っており、他のモードを選べる状態は複雑さの割に恩恵が薄いと判断したためです。n-gram によるタイブレーク（3キー分岐・重なり不足判定）は confirm_mode の値に関わらず常に有効です。変更したい場合は下記「確定モードの選択肢」の通り config.toml を直接編集してください。同時打鍵の3キー分岐・重なり不足判定のマージン（timing_margin_percent/min_overlap_margin_percent）は「上級者向け設定」タブのスライダーから調整できます。
config.toml 手動設定）
設定画面には現在この項目はありません。変更したい場合は config.toml の
[general] セクションに confirm_mode を直接記述してください（既定: wait）。
| モード | 動作 | 向いている人 |
|---|---|---|
| wait（既定） | タイムアウトまで保留してから確定。最も正確 | ゆっくり正確に打ちたい方 |
| speculative （廃止予定） | 即時出力し、同時打鍵なら差し替え。two_phase（speculative_delay_ms=0）と完全に等価なため、設定すると自動的にそちらへ読み替えられます | — |
| two_phase | 短い待機後に投機出力。wait と即時出力の中間。speculative_delay_ms で待機時間（ms）を指定 | バランス重視の方 |
| adaptive_timing | 連続打鍵中は wait、途切れたら投機。速度に自動適応 | 打鍵速度にムラがある方 |
| ngram_predictive | n-gram 統計で投機/待機を動的判断。文脈を使って精度向上 | 最も賢い判定を使いたい方（推奨） |
| 項目 | 説明 |
|---|---|
| 左親指キー | 左親指シフトキーに使うキー（デフォルト: VK_NONCONVERT = 無変換） |
| 右親指キー | 右親指シフトキーに使うキー（デフォルト: VK_CONVERT = 変換） |
| IME ON/OFF キー | awase が能動的に送信する IME ON/OFF キー（冪等）。複数登録可 |
| IME ON/OFF トグル | 押した時点の IME 状態に応じて ON⇔OFF を反転するキー。既定: 漢字キー。複数登録可 |
親指シフト入力／ローマ字入力の切り替えキー（旧称「親指シフト ON/OFF キー」）は「上級者向け設定」タブに移動しました。詳細は下記「上級者向け設定タブ」を参照してください。
GJI（Google 日本語入力）を使っていて無変換キーを親指キーに選んでいる場合、awase.exe は起動時・GJI 検出時に config1.db を読み、無変換キー単独タップで専用の Fn キー（既定候補: F21）を送るよう自動的に判定します（「専用Fnキー変換」、ADR-091 §D3.2）。これは無変換キーの単独タップで文字種（ひらがな/カタカナ等）をトグルしたく、かつ「モードずれ」（awase 側の想定と GJI 側の実際の状態が食い違う問題）を避けたい上級者向けの機能です。GJI 側の config1.db にこの Fn キーの「かな種別切替」バインドがまだ無い場合は、awase.exe がポップアップで設定を提案します（同意すれば自動で追加、バックアップ付き）。設定画面（本ページ）からの手動操作は現在提供していません。特定の Fn キーへ固定したい場合は下記「GJI 専用Fnキー変換の手動設定」の通り config.toml を直接編集してください。
「IME → awase」方向（外部 IME の状態変化を awase が解釈するための設定、半角/全角キー等）は GUI から撤去しました。既定は空欄で通常は不要なうえ、他の候補（IME オン/オフキー）は物理的に存在しないキーのため GUI で選ばせる価値が薄いと判断したためです。必要な場合は下記「IME 検出キーの手動設定」の通り config.toml を直接編集すれば引き続き設定できますが、上記「IME ON/OFF トグル」と同じキーは指定しないでください（二重処理で正しく動作しなくなります）。
通常は GJI 検出時に awase.exe が config1.db を自動判定し（必要ならポップアップで
設定を提案）、追加の操作は不要です。自動判定がうまく働かない場合や、意図的に
特定の Fn キーへ固定したい場合のみ、以下のように config.toml を
直接編集してください（設定画面には現在この項目はありません）。
指定した Fn キーに GJI 側の config1.db で「かな種別切替」が割り当てられている 必要があります。GJI のプロパティ画面（タスクトレイのアイコン右クリック→ 「プロパティ」→「キー設定」タブ）で「入力補助」を「カスタム」にしたうえで、 awase.exe を起動（または GJI へフォーカス）すればポップアップから設定を追加 できます。config1.db への書き込みが GJI へ確実に反映されるのは サインアウトしてからサインインし直したときです。タスクトレイ から GJI を「終了して再起動」すると、GJI 終了時にメモリ上の（書き込み前の） 設定でファイルが上書きされ、変更が消えることがあります。
プロセス名とウィンドウクラス名の組み合わせで、アプリごとに動作を上書きします。
| 設定種別 | 説明 | 用途例 |
|---|---|---|
| テキスト入力として強制 | 自動判定に関わらず常に NICOLA 入力を有効にする | 誤ってバイパスされるアプリ |
| バイパスとして強制 | 常にエンジンを無効にする | スタートメニュー、パスワードマネージャー |
| VK 出力モードとして強制 | ローマ字を VK キーストロークで送信する | Chrome・Edge・Electron ベースのアプリ |
| TSF 出力モードとして強制 | TSF ネイティブモードで送信する | Windows Terminal など TSF 直結アプリ |
プロセス名・クラス名は awase.exe --debug で起動したときのログで確認できます。
日常的に触らない設定をまとめたタブです。
| 項目 | 説明 |
|---|---|
| 親指シフト入力にする | 親指シフト入力（NICOLA変換）に切り替えるキー（旧称「親指シフト ON キー」）。複数登録可 |
| ローマ字入力にする | ローマ字入力（変換なしで素通し）に切り替えるキー（旧称「親指シフト OFF キー」）。複数登録可 |
| 単独5連打でローマ字入力にする | 指定キーを400ms以内に5回連続タップするとローマ字入力に切り替える、Ctrl スタック等の緊急脱出用の設定 |
| 親指シフト入力／ローマ字入力 切替 | グローバルホットキーで親指シフト入力⇔ローマ字入力をトグル（旧称「親指シフト切替ホットキー」、既定: Ctrl+Shift+F12） |
| 3キー分岐マージン | 文字→親指→文字と3キーが来た場合に、タイミングだけで確定するか n-gram で判定するかの境界（%） |
| 重なり不足マージン | 文字キーと親指キーの物理的な重なり時間がこの割合未満だと「重なり不足」とみなす境界（%） |
| Alt+かな による IME 入力方式切替を無効化する | MS-IME の「ローマ字入力⇔JISかな直接入力」切替ショートカットをブロック（既定: ON。JISかな直接入力に切り替わると awase 側からは復帰できないための保護） |
| GJI の無変換/変換/ひらがな/カタカナキー状態依存トグルを追従する | GJI 側のキーマップ設定がこれらのキーに状態依存の IME ON/OFF トグルを割り当てている場合、ベストエフォートで追従する（既定: OFF、自己責任。非冪等な動作のため既定では無効。詳細は known-bugs.md の BUG-115 を参照） |
| 左Shift単独タップで半角英数トグルを有効にする | 左Shift単独タップで、IMEをONにしたまま半角英数入力に切り替える（既定: OFF、実機ソーク中の機能） |
| n-gram ファイル | n-gram 統計データのパス（.csv.gz または .toml）。同時打鍵のタイブレークに confirm_mode を問わず常に使われる |
| n-gram 調整幅 | n-gram 予測で同時打鍵閾値を調整する幅（ms） |
| n-gram 最小/最大閾値 | n-gram 予測で調整される閾値の下限・上限（ms） |
| フォーカスデバウンス | Alt+Tab 連続操作時の誤検知を防ぐ待機時間（ms） |
| IME ポーリング間隔 | マウスで言語バーを操作したときなどの変化を検出する周期（ms） |
| レイアウトディレクトリ | .yab ファイルを置くフォルダのパス |
CapsLock（JISキーボードでは英数キー）と左Ctrlの役割を、Windowsのレジストリ（Scancode Map）を書き換えて変更する機能です。3択（無効／入れ替え／追加）から選べます。
| 選択肢 | 動作 |
|---|---|
| 無効 | 変更しない（既定） |
| Caps(英数) ⇔ Ctrl を入れ替える | CapsLock（英数）キーとCtrlキーの役割を入れ替える |
| Caps(英数) を Ctrl として追加する | CapsLock（英数）キーを追加のCtrlキーにする。元のCtrlキーはそのまま使えるが、英数キー自体は使えなくなる |
変更には管理者権限の確認（UAC）が1回表示され、反映には再起動が必要です（サインアウトのみでは反映されないことがあります）。この設定はPC全体（全ユーザー）に影響し、リモートデスクトップのセッション内では動作しません。
awase の動作は config.toml で細かく調整できます。
以下がデフォルト値です。config.toml に [keys] セクションを追加して上書きできます。
engine_on_ime_key/engine_off_ime_key（エンジン ON/OFF 時に IME の全角/半角モードを強制送信する上級者向け設定）は既定で無効（未設定）です。IME の開閉（ON/OFF）とモード強制を1つのキーで同時に行う複合的な設定のため、通常は上記の ime_on/ime_off で十分です。手動で config.toml に追記すれば有効化できます。
複数キーを割り当てるには配列に追加してください: ["Ctrl+Shift+変換", "Ctrl+F8"]
グローバルホットキー（アプリのフォーカスに関係なく機能）は [general] の engine_toggle_hotkey = "Ctrl+Shift+F12" で設定します。
新しい Microsoft IME（Windows 10 20H1 以降）では unicode モードを推奨します。per_key / batched では入力が正しく処理されない場合があります。
MSI インストーラー・ZIP 版の install.ps1 のいずれでインストールした場合も、確認ダイアログなしで Windows ログオン時の自動起動が既定で有効になります。無効にしたい場合は、トレイアイコンのメニューか、以下の auto_start 設定で変更できます。
自動起動は HKCU\Software\Microsoft\Windows\CurrentVersion\Run レジストリに登録されます。スタートアップフォルダは使用しません。
タスクトレイアイコンを右クリックすると、最新バージョンを確認して新しい版があればメニューに表示します（設定画面の「更新を確認」チェックボックスでも切り替えられます）。バージョン・OS・端末固有の情報は送信しません。無効にしたい場合や、無人展開でこのファイルを直接配置する場合は以下の設定を使います。
この設定は config.toml と同じ場所（インストール先ディレクトリ）にあるユーザーごとの設定であり、機械全体へ一括適用する仕組みはありません。企業展開でまとめて無効化したい場合は、各ユーザーのプロファイルに配置するか、ネットワーク側で report.awase.cc への到達を遮断してください（遮断しても動作に影響はありません）。
スタートメニューや検索バーで誤動作する場合は force_bypass に追加してください。
外部 IME の状態変化（半角/全角キー等）を awase が検出するための設定です。GUI には無く config.toml の直接編集でのみ設定できます（多くの利用者には不要なため、GUI からは意図的に外してあります）。toggle の既定は空です。漢字キーは「キー設定」タブの「IME ON/OFF トグル」（keys.ime_toggle、既定: 漢字キー）が能動的に処理するため、ここに重ねて設定すると同じキーを二重処理してしまい正しく動作しません。
1つのキーで「文字を出力してから確定操作を送る」など、複数の動作をまとめて実行できる機能です（やまぶきの CV4D 相当）。既定では無効（Off）です。GUI にはまだトグルがなく、config.toml の直接編集でのみ有効化できます。
有効化すると、.yab の1セル内で + 区切りにより複数の動作を並べられます。CV4D は Ctrl+M（変換候補の確定によく使われるキー）を表す記法です。
上の例は「。を出力してから Ctrl+M で確定する」という動作を1セルで定義しています。同じ動作を複数キーで使い回したい場合は、[[keystroke_macro]] で名前を付けて @名前 で参照できます。
既存の .yab ファイルは有効化しても壊れません（+ を含まないセルは今まで通り解釈されます）。ただし、やまぶき形式で無区切り（例: ．CV4D）と書かれたセルは、+ を挿入した形（．+CV4D）に書き換える必要があります。
入力がおかしくなったときや、エンジンを強制的に止めたいときの操作です。
修飾キーがスタックした・IME が混乱した・保留中の文字が残っているなど、入力全体がおかしくなったときに使います。
方法 1 — トレイアイコン（マウスが使えるとき・より確実）
タスクバーの awase アイコンを右クリック →「プロセスを再起動」
awase プロセスを完全再起動します。スタックした状態を確実にクリアできます。
方法 2 — キーボードショートカット（パニックリセット）
Ctrl+無変換 → Ctrl+変換 → Ctrl+無変換 を 2秒以内 に素早く入力する
（IME-OFF → IME-ON → IME-OFF のシーケンス。同じキーの連打では発動しません）
方法 2 の効果：
成功するとトレイバルーン通知「状態をリセットしました」が表示されます。
Ctrl キーがスタックしているなど、通常のショートカットも効かない状態で NICOLA エンジンを強制的に止めたいときの最終手段です。 デフォルトで有効（無変換キーに割り当て済み）です。
操作： 無変換 を他のキーと同時押しせず、単独で 400ms 以内に3回 連打する
※ 通常の親指シフト入力中は「親指キー単独タイムアウト」としてカウントされるため、 タイピングの流れで誤発動しにくい設計になっています。
親指シフト配列は .yab ファイルで定義されています。複数の配列を使い分けることができます。
default_layout = "nicola.yab" でデフォルトを変更.yab ファイルを config.toml の layouts_dir に指定したフォルダに配置します（デフォルトは config/）.yab 形式の詳細は GitHub の README を参照してください。
動作がおかしいときはログを確認してください。
awase.exe と同じフォルダの awase.log（起動のたびに追記されます）%USERPROFILE%\scoop\apps\awase\current\awase.log詳細なログが必要な場合はコマンドプロンプトからデバッグモードで起動します。
または環境変数 RUST_LOG=debug を設定してから起動しても同じです。
トレイアイコンから直接、開発者に不具合を報告できます。
report.awase.cc）へ送信されます。GitHub Issue など公開の場所には投稿されませんconfig.toml に保存されます。機械全体へ一括適用するオプトアウト機構はありませんWindows の「設定 → アプリ」または「コントロールパネル → プログラムのアンインストール」から awase を選択してアンインストールします。
解凍したフォルダ内の uninstall.ps1 を PowerShell で実行します。既定では config.toml と配列ファイル（layout/）は削除されません（アップグレードのため一時的に終了・削除する場合を想定した挙動です）。完全に削除したい場合は uninstall.ps1 -Purge を実行してください。
注意: バージョンアップのために uninstall.ps1（や手動でのフォルダ削除）を先に行う必要はありません。新しい ZIP を解凍して install.ps1 を再実行するだけで、既存の設定・配列ファイルを保持したままアップグレードできます。
初めて使うときの推奨手順です。
config.toml 手動設定）config.toml の [general] セクションを直接編集するconfirm_mode = "ngram_predictive"（推奨）で試す"wait"（既定）に変更（正確だがやや遅め）"adaptive_timing" を試す「あ」が一瞬チラッと見えることがあります（捨て打ち機能）
Chrome や Windows Terminal では、IME ON 直後の最初の入力時に「あ」が瞬間的に表示されてすぐ消えることがあります。 これは 捨て打ち機能 が正常に動作しているサインです。
Chrome などの TSF アプリでは IME の入力受付が完了しているかどうかを外部から確認する公式な手段がありません。 そこで awase は「A キーを打って BS で消す」という操作を画面描画前に一瞬行い、 IME が「あ」に変換できたかどうかを観測することで入力受付の完了を確認しています。 この捨て打ちで得た情報をもとに、本来打ちたい文字を正確なタイミングで送ります。 通常は画面に何も表示されませんが、タイミングによって「あ」がほんの一瞬見えることがあります。
利用者から寄せられた質問と回答をまとめました。
IME の入力方式が「ローマ字入力」ではなく「かな入力」になっている可能性が高いです。
たとえば「と」（ローマ字では to）を JIS かな配列のキー位置として読むと「から」に、
「か」（ka）は「のち」になる、というように、打ったローマ字がそのまま
JIS かな配列上の文字として出力されると再現する症状です。
awase はローマ字入力であることを前提に動作しています。IME 側の設定を確認し、 入力方式を「ローマ字入力」に戻してください。awase 側から IME を JIS かな入力へ 遷移させる手段は存在しないため、awase が自動的にこの状態を検出して直すことはできません。
既定では、IME の誤動作防止のため親指キー（変換・無変換）の単独タップは常に無視されます （設定画面「キー設定」タブの「変換キー単独タップを常に無視する」「無変換キー単独タップを 常に無視する」がいずれも既定で有効）。
親指キーの単独タップを変換候補の送り選びに使いたい場合は、実際に親指キーへ割り当てている方 （左親指キーが無変換なら「無変換キー単独タップを常に無視する」、右親指キーが変換なら 「変換キー単独タップを常に無視する」）のチェックを外してください。
同時打鍵のつもりで打った他のキーが、タイミングによって無変換キーの単独タップとして 検出されてしまうことがあります。上の項目でチェックを外している場合、この単独タップが そのまま OS・IME に送られ、意図しないモード切り替えを引き起こします。
「無変換キー単独タップを常に無視する」にチェックを入れる（既定は有効）と、単独タップを 一切送出しなくなり誤反応を防げます。ただし、この設定を有効にすると上の項目の 「親指キーで候補送り」はできなくなるため、両立しない点に注意してください。
基本設定タブの「同時打鍵閾値」（既定 100ms）を少し上げてみてください。自分の打鍵速度に
合わせて 150〜250ms あたりで調整すると改善することがあります。config.toml を
直接編集する場合は simultaneous_threshold_ms を書き換えます。
正常動作です。「捨て打ち機能」による cold start 対策で、IME の入力受付準備ができているかを 確認するために一瞬だけダミー文字を送っています。詳しくは「初期設定の手順」の 「Chrome / Edge での入力がうまくいかない場合」を参照してください。テキストエディタなど アプリによっては warm 状態が保たれているため、この現象自体が起きないこともあります。
ページ上部の「NICOLA 標準配列図」に全キーの割り当てが図示されています。独自配置にしたい
場合は、設定画面の「配列編集」タブまたは .yab ファイルの直接編集で変更できます。
Japanist・やまぶきR など、awase と同じくキーボード入力をフックする常駐ソフトとの併用は 避けてください。競合により入力が不安定になることがあります。awase に乗り換える場合は、 既存の親指シフトソフトをアンインストールしてから使用してください。