Skip to content

About

A lightweight Windows 11 tray utility that shows the Japanese IME ON state near the mouse cursor, with global hotkeys, process priority rules and power mode switching.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

IMEIndicator

IMEIndicator は、Windows 11 上で日本語 IME の ON 状態をマウスカーソル付近に表示する常駐アプリです。通常はタスクトレイに常駐し、設定画面から表示サイズやオフセット、プロセス優先度ルールを変更できます。

Important

.NET 10 / C# 実装に全面移行しました(旧ネイティブ C++ 実装は廃止)。自己完結・単一 EXE (約 72 MB)として配布され、.NET ランタイムの事前導入は不要です。

できること

  • 日本語 IME が ON のときだけ、カーソル付近にインジケーターを表示する
  • 電源モードに応じてインジケーター色を切り替える
  • タスクトレイから設定画面、表示切替、電源モード切替、終了を行う
  • 指定したプロセスの優先度を自動で変更する
  • E-Core 搭載 CPU では、対象プロセスを E-Core のみに固定する
  • HotkeyP 由来のグローバルホットキー機能 (v1.4.0〜): 任意のキー組合せでアプリ起動・URL 起動・内部コマンド (130+種) を実行できる

対応環境

  • Windows 11 64-bit
  • ランタイム不要(自己完結・単一 EXE として配布。.NET 10 ランタイムの事前導入は不要)

Note

配布された IMEIndicator.exe を任意のフォルダに置くだけで動作します(管理者権限不要)。プロセス優先度ルールでシステムプロセスを操作する場合のみ管理者権限を推奨。

入手

Releases から IMEIndicator.exe をダウンロードします。インストール作業はなく、単一の実行ファイルを任意の場所に置いて起動するだけです。

配布物は GitHub Actions が本リポジトリからビルドしたものです(.github/workflows/build.yml)。

Warning

実行ファイルは現在コード署名されていません。Windows の Smart App Control が有効な環境では起動がブロックされることがあります。その場合は、ダウンロードした IMEIndicator.exe のプロパティで「セキュリティ: 許可する」にチェックを入れてから起動してください。

クイックスタート

  1. IMEIndicator.exe を起動します。
  2. 初回起動時は設定ウィンドウが自動で開きます。
  3. 日本語 IME を ON にすると、マウスカーソルの近くにインジケーターが表示されます。
  4. 設定ウィンドウを閉じてもアプリは終了せず、タスクトレイに常駐し続けます。
  5. 終了するときは、タスクトレイアイコンを右クリックして 終了 を選択します。

基本的な使い方

通常起動

IMEIndicator.exe を通常起動すると、以下の動作になります。

  • 設定ファイルを読み込む
  • IME 状態の監視を開始する
  • マウスカーソル追従ウィンドウを初期化する
  • タスクトレイアイコンを表示する
  • 初回起動時だけ設定ウィンドウを表示する

タスクトレイ操作

タスクトレイアイコンの操作は次の通りです。

操作 動作
左クリック 設定ウィンドウを開く
右クリック コンテキストメニューを開く

右クリックメニューでは以下を実行できます。

  • 表示切替: カーソル付近のインジケーター表示を ON/OFF する
  • 電源モード: 最適な電力効率 / バランス / 最適なパフォーマンス を切り替える
  • 設定: 設定ウィンドウを開く
  • 終了: アプリを終了する

インジケーター表示ルール

  • 日本語 IME が ON のときだけ表示されます
  • IME が OFF のときは非表示になります
  • 日本語以外の入力状態では表示されません
  • 表示文字は既定で あ です

電源モードと色

インジケーター背景色は Windows 11 の電源モードに連動します。

電源モード 色
最適な電力効率 青
バランス 赤
最適なパフォーマンス 黄

設定ウィンドウ

設定ウィンドウには 2 つの主要タブがあります。

インジケーター

変更できる項目は次の通りです。

  • 表示の ON/OFF
  • サイズ
  • カーソルからの X オフセット
  • カーソルからの Y オフセット
  • 不透明度

プロセス優先度

指定したプロセスに対して、自動的に優先度を適用できます。

  • 監視間隔は 1 秒から 1800 秒まで設定できます
  • ルールは最大 30 件まで追加できます
  • プロセス名は入力補完に対応します
  • 優先度は Windows の 6 段階に対応します
  • E-Core 搭載 CPU では E-Core 固定を有効にできます

優先度として選べる値は次の通りです。

  • Idle
  • BelowNormal
  • Normal
  • AboveNormal
  • High
  • Realtime

ホットキー (v1.4.0〜)

設定ダイアログ下部の「ホットキー」セクションで、任意のキー組合せにアクション(アプリ起動・URL 起動・内部コマンド)を割り当てられます。HotkeyP 4.11 由来のコア実装を移植しています。

主要機能:

  • キー登録: 修飾キー (Ctrl/Alt/Shift/Win) + 任意の通常キー、ファンクションキー、マルチメディアキーの組合せ
  • アクション: 実行ファイル / URL / フォルダの起動、または 130+ 種の内部コマンド (音量、電源、ウィンドウ操作、テキスト貼付け、IME インジケーター切替など)
  • オプション: 起動時自動実行 (autoStart)、複数インスタンス制御 (multInst)、トレイメニュー表示 (trayMenu)、管理者として実行 (admin)
  • トレイメニュー: trayMenu フラグを ON にしたエントリは、トレイ右クリックメニューからも実行可能

代表的な内部コマンド ID:

ID 動作
13 音量 +5%
14 音量 -5%
17 ミュート切替
63 画面ロック
17 システムシャットダウン
67 テキスト貼付け(args にテキスト指定)
200 IME インジケーター表示切替
210 電源モード切替(バックアップ付き)
211 高パフォーマンス電源プラン適用

内部コマンドの一覧は、設定ダイアログのホットキー編集画面にあるコマンド選択リストで確認できます。

ホットキー編集ダイアログ:

  • ショートカット: テキストボックスにフォーカスして直接キーを押すと記録される(修飾キー+通常キー)
  • アクション種別: 「アプリ・URL・フォルダ起動」または「内部コマンド」をラジオボタンで選択
  • exe / URL / パス: 実行対象(参照ボタンで OPENFILENAME ダイアログ)
  • 引数 / 作業ディレクトリ: 起動時のオプション
  • 内部コマンド ID: -1 = 非コマンド、0-120 = HotkeyP 由来、200-299 = IMEIndicator 拡張
  • フラグ: 無効化、複数起動許可、トレイメニュー表示、起動時自動実行、管理者として実行

コマンドライン引数

/powertoggle

次のコマンドを実行すると、Windows 11 の電源モードをトグルします。

IMEIndicator.exe /powertoggle

挙動は次の通りです。

  • 起動中の IMEIndicator があれば、その常駐インスタンスに切替要求を送る
  • 起動中のインスタンスがなければ、その場で電源モードを切り替えて通知だけ表示して終了する
  • トグル対象は 最適な電力効率 と バランス
  • 現在が 最適なパフォーマンス の場合は バランス に切り替わる

設定ファイル

設定ファイルは次の場所に保存されます。

%APPDATA%\IMEIndicator\settings.json

設定は JSON 形式で保存され、アプリ終了時や設定変更時に書き込まれます。

主な項目は次の通りです。

  • mouseCursorIndicator.isVisible
  • mouseCursorIndicator.size
  • mouseCursorIndicator.opacity
  • mouseCursorIndicator.offsetX
  • mouseCursorIndicator.offsetY
  • imeOnText
  • imeOffText
  • processPriorityRules
  • pollingIntervalSeconds
  • backgroundImage.isVisible
  • backgroundImage.size
  • backgroundImage.opacity
  • backgroundImage.imagePath
  • backgroundImage.position

ビルド

前提

ビルド・テスト

dotnet build IMEIndicator.slnx -c Release
dotnet test IMEIndicator.slnx -c Release

配布用ビルド(自己完結・単一ファイル)

dotnet publish src/csharp/IMEIndicator/IMEIndicator.csproj -c Release -r win-x64 `
  --self-contained true -p:PublishSingleFile=true -p:EnableCompressionInSingleFile=true `
  -o dist/csharp

成果物: dist/csharp/IMEIndicator.exe(自己完結・単一ファイル、約 72 MB。.NET ランタイムの事前導入は不要)。

バージョン管理

リリースビルドごとに src/csharp/IMEIndicator/IMEIndicator.csproj の <Version> を 1 つずつインクリメントしてください(FR-009)。

配布

dist/csharp/IMEIndicator.exe をそのまま配布できます。自己完結ビルドのため、.NET ランタイムの事前導入は不要です。

未署名のため、Windows の Smart App Control が有効な環境では起動がブロックされる可能性があります。 その場合は、ダウンロードした IMEIndicator.exe のプロパティで「セキュリティ: 許可する」にチェックを 入れてから起動してください(上記「入手」節と同じ対処法)。

補足

  • 設定ウィンドウはタスクバー直上に表示されます
  • 設定ウィンドウを開けるのは 1 つだけです
  • アプリはシングルインスタンス動作です(名前付き Mutex IMEIndicator_SingleInstance)

ライセンス

本プロジェクトは GNU General Public License v2 (or later) で配布されます。完全なライセンス本文は COPYING を参照してください。

注: GPL は HotkeyP(後述)由来コードを取り込んだ結果としての必然的な選択です。ホットキー機能のコア実装が GPL v2 の派生物であるため、本プロジェクト全体を GPL v2 (or later) 以外のライセンスで配布することはできません。

謝辞 (Acknowledgments)

  • HotkeyP by Petr Lastovicka — グローバルホットキー機能のコア実装は HotkeyP 4.11(GPL v2)から派生しています。原典: https://hotkeyp.sourceforge.net/ / https://github.com/plastovicka/HotkeyP。HotkeyP 由来のソースは src/csharp/IMEIndicator/Services/Hotkey/ および src/csharp/IMEIndicator/Models/Hotkey/HotKeyEntry.cs に配置されており、各ファイル先頭に著作権表記とライセンスヘッダを保持しています。

About

A lightweight Windows 11 tray utility that shows the Japanese IME ON state near the mouse cursor, with global hotkeys, process priority rules and power mode switching.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages