https://roguer.info/tags/keyd/ Recent content in Keyd on Roguer Hugo -- gohugo.io ja Sat, 15 Aug 2026 18:23:00 +0900 https://roguer.info/p/%E3%82%AD%E3%83%BC%E3%83%9C%E3%83%BC%E3%83%89%E3%81%AE%E3%83%AA%E3%83%9E%E3%83%83%E3%83%97/ Sat, 15 Aug 2026 18:23:00 +0900 https://roguer.info/p/%E3%82%AD%E3%83%BC%E3%83%9C%E3%83%BC%E3%83%89%E3%81%AE%E3%83%AA%E3%83%9E%E3%83%83%E3%83%97/ <img src="https://roguer.info/" alt="Featured image of post CachyOS + KDE Plasma(Wayland)で物理的に壊れたキーをkeydで代用する" /><p>キーボードの <code>:</code>(コロン)/<code>;</code>(セミコロン)キーが壊れてしまい、入力できなくなりました。物理キーを買い替える前に、使っていないキーの組み合わせで代用できないか試してみました。</p> <ul> <li>OS: CachyOS(Arch系)</li> <li>デスクトップ環境: KDE Plasma(Wayland)</li> </ul> <p>Waylandでは、X11の<code>setxkbmap</code>のような手軽な方法が使えないことが多く、GUIのキーボード設定でも「Alt+P → <code>;</code>」のような任意のキー組み合わせへのカスタムマッピングはできません。そこで、カーネルレベルで動作しX11/Wayland/デスクトップ環境を問わず使える<code>keyd</code>を採用しました。</p> <h2 id="keydとは">keydとは </h2><p><code>keyd</code>はLinuxのキーリマップ用デーモンで、<code>/dev/input</code>のイベントを直接フックして仮想キーボードとして出力し直します。ディスプレイサーバーやウィンドウマネージャーに依存しないため、Wayland環境でも問題なく動作します。</p> <h2 id="インストール">インストール </h2><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">sudo pacman -S keyd </span></span></code></pre></div><h2 id="設定">設定 </h2><p><code>/etc/keyd/default.conf</code> を作成します。</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-ini" data-lang="ini"><span class="line"><span class="cl"><span class="k">[ids]</span> </span></span><span class="line"><span class="cl"><span class="na">*</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="k">[main]</span> </span></span><span class="line"><span class="cl"><span class="na">leftalt</span> <span class="o">=</span> <span class="s">overload(altremap, leftalt)</span> </span></span><span class="line"><span class="cl"><span class="na">rightalt</span> <span class="o">=</span> <span class="s">overload(altremap, rightalt)</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="k">[altremap]</span> </span></span><span class="line"><span class="cl"><span class="na">p</span> <span class="o">=</span> <span class="s">semicolon</span> </span></span><span class="line"><span class="cl"><span class="na">o</span> <span class="o">=</span> <span class="s">S-semicolon</span> </span></span></code></pre></div><p>ポイントは以下の通りです。</p> <ul> <li><code>overload(altremap, leftalt)</code> によって、Altキーは単独で押せば通常のAltとして機能し、他のキーと同時に押されたときだけ<code>altremap</code>レイヤーが有効になります</li> <li><code>p = semicolon</code> で <strong>Alt+P → <code>;</code></strong></li> <li><code>o = S-semicolon</code> で <strong>Alt+O → <code>:</code></strong>(Shift+セミコロン相当)</li> </ul> <p>サービスを有効化します。</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">sudo systemctl <span class="nb">enable</span> --now keyd </span></span></code></pre></div><h2 id="ハマった所-右ctrlで日本語変換ができなくなった">ハマった所: 右Ctrlで日本語変換ができなくなった </h2><p>設定を反映した直後、右Ctrlキーによる日本語入力の変換切り替え(fcitx/ibus)が効かなくなる問題が発生しました。</p> <p><code>sudo keyd monitor</code> で右Ctrlキーを押したときのイベントを確認したところ、原因がわかりました。</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"><span class="line"><span class="cl">keyd virtual keyboard 0fac:0ade:bea394c0 leftcontrol down </span></span><span class="line"><span class="cl">keyd virtual keyboard 0fac:0ade:bea394c0 leftcontrol up </span></span></code></pre></div><p>右Ctrlキーを押しているのに、keydの出力は<code>leftcontrol</code>になっていました。これでは右Ctrl固有のショートカットに割り当てていたIMEの変換トリガーが反応しません。</p> <p><code>[main]</code>セクションに右Ctrlを明示的にそのまま通す設定を追加します。</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-ini" data-lang="ini"><span class="line"><span class="cl"><span class="k">[main]</span> </span></span><span class="line"><span class="cl"><span class="na">leftalt</span> <span class="o">=</span> <span class="s">overload(altremap, leftalt)</span> </span></span><span class="line"><span class="cl"><span class="na">rightalt</span> <span class="o">=</span> <span class="s">overload(altremap, rightalt)</span> </span></span><span class="line"><span class="cl"><span class="na">rightcontrol</span> <span class="o">=</span> <span class="s">rightcontrol</span> </span></span></code></pre></div><p>これで右Ctrlが正しく<code>rightcontrol</code>として出力されるようになり、日本語変換も元通り動くようになりました。</p> <h2 id="最終的な設定ファイル">最終的な設定ファイル </h2><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-ini" data-lang="ini"><span class="line"><span class="cl"><span class="k">[ids]</span> </span></span><span class="line"><span class="cl"><span class="na">*</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="k">[main]</span> </span></span><span class="line"><span class="cl"><span class="na">leftalt</span> <span class="o">=</span> <span class="s">overload(altremap, leftalt)</span> </span></span><span class="line"><span class="cl"><span class="na">rightalt</span> <span class="o">=</span> <span class="s">overload(altremap, rightalt)</span> </span></span><span class="line"><span class="cl"><span class="na">rightcontrol</span> <span class="o">=</span> <span class="s">rightcontrol</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="k">[altremap]</span> </span></span><span class="line"><span class="cl"><span class="na">p</span> <span class="o">=</span> <span class="s">semicolon</span> </span></span><span class="line"><span class="cl"><span class="na">o</span> <span class="o">=</span> <span class="s">S-semicolon</span> </span></span></code></pre></div><p>Wayland環境でも<code>keyd</code>を使えばDE非依存でキーの自由なリマップができます。<code>overload()</code>を使うと、修飾キーの通常の機能を保ったままレイヤー切り替えキーとしても使えるのが便利でした。</p> <p>keydはデフォルトで一部のキー(今回の場合は右Ctrl)を暗黙的に別のキーとして正規化して出力することがあるようです。既存のショートカットに影響が出た場合は<code>sudo keyd monitor</code>で実際の出力イベントを確認し、必要なキーは明示的にパススルー設定するとよさそうです。</p>