Waylandでアプリケーション毎にキー配列を変えられるようなリマッパーを探していたのだが、なかなか良いものが見つけられずにいた。
最近ふとしたことで、<a href="https://github.com/xremap/xremap">Xremap</a>を目にすることがあり、READMEをあらためて読んでみた。
このツール自体は昔から知っているのだが、当時はPython製で、Waylandはサポートされていなかったと記憶している。
しかしいまはRustで書かれていて、Waylandにも対応していた。そしてわたしのやりたいことはすべてサポートされているように見えた。すごい進化だ…！
というわけで試してみることにした。

<h3>インストール</h3>
自分の環境はArch Linuxで、<a href="https://isaacfreund.com/software/river/">river</a>を使っている。
riverはwlroots系なので以下をインストール
<pre><code class="sh">&#10095; paru -S xremap-wlroots-bin</code></pre>

<h3>設定</h3>
ユーザーをinputグループにいれて、udevのルールを追加。
<pre><code class="sh">&#10095; sudo usermod -a -G input $USER
&#10095; echo 'KERNEL=="uinput", GROUP="input", TAG+="uaccess"' | sudo tee /etc/udev/rules.d/99-input.rules</code></pre>

で、再起動。

<h3>リマップ設定</h3>
それでこれらのツールで実現したいことの基本的なことは以下の通り:
<ul>
<li>SpaceキーをShiftとして利用。しかし単独で押したときはSpaceとして機能する
<ul>
<li>特定のアプリケーション(主にゲーム)ではこの機能は無効にしたい</li>
</ul></li>
<li>キーボードハードウェア毎の配列の調整</li>
</ul>

Xremapでこれらをみたす設定はこんなかんじになった。
<pre><code class="yaml">shared:
 games: &amp;games
 - steam_app_default # DiabloIV
 - steam_app_2694490 # POE2

modmap:
 - name: SandS
 application:
 not: *games
 remap:
 Space:
 held: Shift_L
 alone: Space
 alone_timeout_millis: 999999999

 - name: HHKB
 device:
 only: "Topre Corporation HHKB Professional"
 remap:
 KEY_GRAVE: KEY_ESC
 KEY_ESC: KEY_GRAVE
 KEY_BACKSLASH: KEY_BACKSPACE
 KEY_BACKSPACE: KEY_BACKSLASH</code></pre>

起動はriverの設定から
<pre><code class="sh">xremap ~/.config/xremap/config.yaml --watch=config,device &amp;</code></pre>

こんな感じで起動すればokそう。

<h4>よくわからなかったところ</h4>
<ol>
<li>alone_timeout_millisの設定</li>
<li>アプリケーションの指定方法</li>
<li>watchコマンドラインオプション</li>
</ol>

<h5>alone_timeout_millisの設定</h5>
このタイムアウトを無効にしたかったので、最初は0を指定してみた。そうするとSpace単独でおしてもSpaceとして機能しなくなってしまったw
その挙動を望む人はいないとおもうのでよくわからないのだが、とりあえず十分大きい値を設定することにした。

<h5>アプリケーションの指定方法</h5>
ドキュメントにはswayの例はあるものの、一般的なwlroots系WMで通用するアプリケーションの指定方法の記載がないため、最初はなにを指定したらいいのかわからなかった。
いろいろやってみたところ、どうやら <code>lswt</code> で取得できる <code>app_id</code> を指定すればよいみたいだ。

<h5>watchコマンドラインオプション</h5>
さいしょ単純に <code>--watch</code> としか指定しなかったら、configの自動リロードなどが動作しないように思えた。 <code>--watch=config</code> などと具体的に指定しないとうごかないっぽい？

<h3>まとめ</h3>
とまぁ、よくわからない点はあったものの、ひとまず満足。Xremapにはほかにも興味深い機能がいろいろあるので、それらもそのうち見てみたい。

2025