Skip to content

v0.1.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 20 Jul 05:07
v0.1.0
8dec8c6

WinRemap v0.1.0 — first release

A per-application key remapper for Windows, written in Rust — inspired by
xremap (Linux) and Keyhac.

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

Highlights

  • Per-application remapping — rules apply only to the exe names you list, or
    globally (*) with an exclude list. App rules always win over global ones.
  • One declarative TOML config with Emacs-style key notation ("C-h" = "Back"),
    familiar to Keyhac/fakeymacs users. Config errors are reported with line
    numbers; a broken reload keeps the previous working config.
  • Two-stroke prefix keys ("A-x u" = "C-z") and macros
    ("C-t" = ["C-Right", "C-Left", "C-S-Right"], up to 8 chords per press).
  • Task tray resident with enable/disable toggle and instant config reload
    (atomic swap — no lost keystrokes).
  • IME status indicator (opt-in): flashes a translucent「あ」panel when the
    IME turns on. Display only — WinRemap never switches the IME.
  • Japanese/English UI, auto-detected from the system language.
  • The hook callback runs in pure Rust with no heap allocation, locking, or I/O —
    no GC pauses, no hook-timeout workarounds.

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.1)

  • Elevated (admin) windows don't receive remapped input (UIPI) unless WinRemap
    also runs elevated.
  • Punctuation/OEM keys (;, ,, …) are not supported yet.
  • A console window stays open (reload errors are printed there).
  • Not recommended alongside other keyboard-hook software (Keyhac, AutoHotkey, …)
    remapping the same keys.

Full details: CHANGELOG ·
Limitations

日本語

Windows 用のアプリ別キーリマッパーです。選んだアプリでだけキーを置き換えられます。
インストール手順・設定方法・FAQ は日本語ヘルプを参照してください。
インストーラー(winremap-setup.exe)は管理者権限不要で、SmartScreen 警告が出た場合は
「詳細情報 → 実行」で起動できます(上記の検証手順の利用を推奨)。

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

Assets 5
Loading