Skip to content

v0.2.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 21 Jul 05:51
v0.2.0
1d498e8

WinRemap v0.2.0 — see what it's doing

The theme of this release is visibility. Launching no longer flashes a console window, and two new windows — a settings viewer and a live log — answer the questions that used to mean opening the config file and guessing.

📖 User guide: https://daikisuganuma.github.io/winremap/ (日本語)

Upgrading from v0.1.0? Your config keeps working as-is. Nothing was removed.

Highlights

  • Settings window (tray → Settings) — shows the config in effect right now: every keymap, its target apps and exclusions, and its remap rules, each with the comment you wrote beside it in the file. Where the same key is bound in more than one keymap, a column names the others — only one of them can win, and that is invisible when reading either keymap alone. A key-notation legend (C- = Ctrl, …) sits alongside the rules.
    • Read-only in this release. Edit the file — the Open in text editor link hands it to whatever you associated with .toml — and press Reload config. The file's modification time and the load time sit side by side, so a config you saved but did not reload is obvious at a glance.
  • Log window (tray → Show log) — watch WinRemap decide, key by key, without starting it from a terminal. It records what you did too: tray picks, window opens, reloads. Debug logging runs only while the window is open, and nothing is ever written to disk.
  • No more console window. Launching from Explorer, the Start menu or at sign-in is now silent. Start it from a terminal and --debug / --help / --version still print there; without one, anything you must not miss (a config error, an unknown argument) becomes a dialog instead of vanishing.
  • IME indicator now works in the Windows 11 Notepad. Notepad is a WinUI 3 app whose editor runs on a second UI thread, and IME open status is per thread — so asking the foreground window always answered "off". WinRemap now asks every input thread of the foreground app.
  • [macro] delay_ms replaces the top-level macro_delay_ms, so it sits in a section like [ime_indicator] does. The old spelling still works; setting both is a validation error rather than a silent winner.
  • Tray menu polish: an app-name/version caption at the top, and icons on the commands.

Install

Installer (recommended)

winremap-setup.exe — per-user, no admin rights; optional start-at-sign-in; creates a starter config if you have none

Portable

winremap.exe — single file, no other footprint

SmartScreen warning? The binaries are not code-signed, so Windows may warn on first run. Click More info → Run anyway — and verify your download below.

Verify your download

(Get-FileHash .\winremap-setup.exe -Algorithm SHA256).Hash.ToLower()   # compare with SHA256SUMS
gh attestation verify .\winremap-setup.exe --repo DaikiSuganuma/winremap

Official binaries are distributed only via GitHub Releases (SECURITY.md).

Known limitations (v0.2)

  • The settings window shows the config; it does not edit it yet. Editing and saving — preserving your comments and ordering — is the next release.
  • Elevated (admin) windows don't receive remapped input (UIPI) unless WinRemap also runs elevated.
  • Punctuation/OEM keys (;, ,, …) are not supported yet.
  • Not recommended alongside other keyboard-hook software (Keyhac, AutoHotkey, …) remapping the same keys.

Full details: CHANGELOG · Limitations

Tray menu icons are from Bootstrap Icons (MIT) — see THIRD-PARTY-NOTICES.md.

日本語

今回のテーマは「何が起きているかを見えるようにする」です。起動時にコンソールウィンドウが出なくなり、
設定ウィンドウとログウィンドウが増えました。設定ファイルを開いて確かめていたことが、その場で分かります。

  • 設定ウィンドウ(トレイ →「設定」) — 今まさに効いている設定を表示します。キーマップごとの対象アプリ・
    除外アプリ・リマップ規則が、設定ファイルの同じ行に書いたコメント付きで並びます。同じキーを複数の
    キーマップが束縛している場合は相手の名前も表示します(実際に効くのは 1 つだけのためです)。
    本バージョンでは閲覧のみで、変更はファイルを編集して「設定を再読み込み」を押してください。
  • ログウィンドウ(トレイ →「ログを表示」) — キーごとの処理内容をその場で確認できます。ログはディスクに
    保存されません。
  • 起動時にコンソールウィンドウが出なくなりました。 ターミナルから起動した場合は従来どおりそちらに出ます。
  • Windows 11 のメモ帳で IME インジケーターが表示されるようになりました。
  • マクロの間隔設定が [macro] の delay_ms に移りました(v0.1 の書き方も引き続き有効です)。

設定ファイルは v0.1.0 のまま動きます。インストール手順・設定方法・FAQ は
日本語ヘルプを参照してください。
インストーラー(winremap-setup.exe)は管理者権限不要で、SmartScreen 警告が出た場合は
「詳細情報 → 実行」で起動できます(上記の検証手順の利用を推奨)。

Developed primarily by AI agents (Claude Code) with human review — see AI-assisted development.

Assets 6
Loading