winget install --id=tsuchim.ImeKeysForUS -e IME Keys for US is a native Windows tray utility that maps standalone Left Alt and Right Alt taps to explicit Japanese IME OFF and IME ON operations while preserving normal Alt shortcuts.
IME Keys for US は、US キーボードで日本語 IME を使う人のための小さな Windows 常駐アプリです。
左 Alt / 右 Alt を IME の明示的な OFF / ON キーとして使います。IME トグルではありません。Word、ブラウザー、VS Code、ターミナルなどを行き来するときに、「いま日本語入力なのか英字入力なのか」を覚えておく負担を減らすことを目的にしています。
このプロジェクトはクリーンなネイティブ実装です。AutoHotkey は含みません。alt-ime-ahk などのコードもコピーしていません。
IME Keys for US は、US キーボードで日本語 IME を使う人のための Windows 常駐アプリです。
テキストエディタやキーボード配列ではありません。起動してもメインウィンドウは表示されず、通知領域 / タスクトレイに常駐します。
目的は、IME の「トグル」操作を避け、英字入力と日本語入力を明示的に切り替えられるようにすることです。
アプリや入力欄を行き来していると、現在の IME 状態を覚えておく必要があります。このアプリは、英字入力にしたいときは左 Alt、日本語入力にしたいときは右 Alt、という操作にすることで、その負担を減らすことを目的にしています。
正常に起動すると、Windows の通知領域 / タスクトレイにアイコンが表示されます。
メインウィンドウは表示されません。
タスクトレイアイコンを右クリックすると、次のメニューが表示されます。
アイコンが見えない場合は、Windows の通知領域で隠れているアイコンも確認してください。
ただし、タスクトレイアイコンがまったく表示されず、Alt キーにも反応しない場合は正常ではありません。v0.1.3 以降では、起動時の状態を次のログに記録します。
%LOCALAPPDATA%\ImeKeysForUS\ime-keys-for-us.log
致命的な初期化失敗が起きた場合は、メッセージボックスも表示します。
このアプリの主な機能は、日本語 IME の ON / OFF を明示的に切り替えることです。
そのため、日本語 IME がインストールされていない環境や、日本語 IME を使っていない入力状態では、左 Alt / 右 Alt を押しても見た目の変化が分かりにくい場合があります。
それでも、アプリが正常に起動していればタスクトレイアイコンは表示されます。
タスクトレイアイコンが表示されない場合は、IME の有無とは別の起動問題として扱ってください。
日本語 IME が入っている環境では、次のように確認できます。
| 入力 | 動作 |
|---|---|
| 左 Alt を 1 回押す | キーを離した時点で IME OFF を要求 |
| 右 Alt を 1 回押す | キーを離した時点で IME ON を要求 |
| 左 Alt を素早く2度押す | 通常の単独の左 Alt |
| 右 Alt を素早く2度押す | 通常の単独の右 Alt |
| 右 Alt を押したまま左 Alt | 通常の単独の左 Alt |
| 左 Alt を押したまま右 Alt | 通常の単独の右 Alt |
| 左 Alt + 他のキー | 通常の左 Alt + 他のキー |
| 右 Alt + 他のキー | 通常の右 Alt + 他のキー |
2 回目の同じ Alt が時間内に押された時点で、「IME ではなく通常の Alt を使いたい」と判断します。2 回目をすぐ離せば単独 Alt として動き、押したまま別のキーを押せば通常の Alt+キーとして動きます。
設定ファイル:
%APPDATA%\ImeKeysForUS\settings.ini
例:
[Keyboard]
DoubleTapMs=100
既定値は 100 ms です。DoubleTapMs は正の整数ミリ秒として読み込まれます。0、負数、非数値、安全に扱えないほど大きい値は既定値になります。DoubleTapMs は 2 回押し時のキャンセル / 復元 window であり、最初の IME ON/OFF 要求を遅らせる時間ではありません。短い値ほど 2 回押し受付時間が短くなり、長い値ほど 2 回押しがしやすくなります。v0.1.x では、設定変更後にアプリの再起動が必要です。
MSI インストール時には自動起動を有効にしません。
現在のユーザーで自動起動したい場合は、タスクトレイメニューから Start at sign-in を有効にしてください。
コマンドでも設定できます。
"C:\Program Files\ImeKeysForUS\ime-keys-for-us.exe" --enable-startup
解除:
"C:\Program Files\ImeKeysForUS\ime-keys-for-us.exe" --disable-startup
IME Keys for US は、テレメトリを収集しません。キー入力内容を記録しません。外部ネットワークへデータを送信しません。
低レベルキーボードフックは、左 Alt / 右 Alt の操作をローカルで判定し、IME の ON / OFF を要求するためだけに使います。
起動診断ログは、ローカル環境の次の場所にだけ保存されます。
%LOCALAPPDATA%\ImeKeysForUS\ime-keys-for-us.log
このログは自動送信されません。
配布用の exe と MSI は、リリース時にローカルの CN=tsuchim コード署名証明書で Authenticode 署名します。
これは個人開発の OSS として、公開 CA のコード署名証明書ではありません。そのため、環境によっては Windows SmartScreen や発行元の警告が表示される場合があります。
それでも、配布 artifact が署名後に改ざんされていないことを確認できるようにするため、署名付き artifact を公開しています。winget では manifest の SHA256 でも installer が検証されます。
SignPath Foundation に申請済みで、現在返答待ちです。受理された場合、SignPath Foundation による署名は署名 workflow 統合後のリリースで導入する予定です。
コード署名ポリシー: docs/code-signing-policy.md
English README: README.en.md
ビルド、署名、UIAccess、リリース手順は docs/development.md を見てください。
手動テスト項目は docs/manual-test-checklist.md にあります。
MIT License. See LICENSE.