Ubuntu で Copilot キーを Ctrl 化する

# x11 か wayland かを確認します。
echo "$XDG_SESSION_TYPE"

# 2つともパスが出ることを確認してください。出なければ sudo apt install x11-utils xinput です。
which xev xinput

id -un
ls -l /dev/input/by-id/ | grep -i kbd
# 例:
# usb-ELECOM_ELECOM_Leggero-event-kbd -> ../event5
# usb-ELECOM_ELECOM_Leggero-if01-event-kbd -> ../event6
# → event-kbd 側 (if01 が付かない方) を使うのが一般的？

ls -l /dev/input/by-id/ | grep -i kbd
# $DEVICE_LINK をメモします。
# 例: /dev/input/by-id/usb-ELECOM_ELECOM_Leggero-event-kbd

sudo evtest
# 一覧から候補を選び、Copilotキーや通常キーを押して反応を見ます。
# Ctrl+C で抜けます。

mkdir -p ~/Documents/apps/keyremap
ls -ld ~/Documents/apps/keyremap

mkdir -p ~/Documents/apps/evsieve
cd ~/Documents/apps/evsieve
git clone --depth 1 https://github.com/KarsMulder/evsieve.git src

cargo --version
rustc --version
# 出なければ https://rustup.rs/ から rustup を入れてください。

mkdir -p debs sysroot
apt-get download libevdev-dev
mv *.deb debs/
dpkg-deb -x debs/libevdev-dev_*.deb sysroot/
LIBRARY_PATH="$PWD/sysroot/usr/lib/x86_64-linux-gnu" cargo build --release --manifest-path src/Cargo.toml
# → src/target/release/evsieve ができます。

./src/target/release/evsieve --help | grep -E "hook|withhold|delay|sequential|send-key"
# 何も出なければ、古いタグを拾っている可能性があります。git pull して再ビルドしてください。

cp ~/Documents/apps/evsieve/src/target/release/evsieve ~/Documents/apps/keyremap/evsieve
chmod +x ~/Documents/apps/keyremap/evsieve
chmod +x ~/Documents/apps/keyremap/remap.sh

#!/bin/bash
set -eu
DIR="$(cd "$(dirname "$0")" && pwd)"
EVSIEVE="$DIR/evsieve"
# ▼ デバイス名に置き換えます。
DEVICE="/dev/input/by-id/usb-ELECOM_ELECOM_Leggero-event-kbd"

usage() {
  echo "Usage: $0 start|stop" >&2
}

wait_for_output() {
  local i=0
  while ! xinput list --name-only 2>/dev/null | grep -qx "kbd-no-copilot"; do
    i=$((i + 1))
    if [ "$i" -ge 100 ]; then
      echo "timed out waiting for kbd-no-copilot" >&2
      return 1
    fi
    sleep 0.2
  done
}

cmd_start() {
  if pgrep -af "[e]vsieve.*kbd-no-copilot" >/dev/null; then
    echo "evsieve is already running. Refusing double grab." >&2
    exit 1
  fi
  # RightCtrl 化する場合です。Copilot キーを完全に無効化するなら --hook の send-key と --delay オプションを外します。
  sudo "$EVSIEVE" \
    --input "$DEVICE" grab \
    --hook key:leftmeta key:leftshift key:f23 sequential period=0.1 send-key=key:rightctrl \
    --withhold \
    --delay key:rightctrl:0 period=0.3 \
    --output name="kbd-no-copilot" create-link="kbd-no-copilot" &
  wait_for_output
  echo "started. Copilot key should now act as RightCtrl."
}

cmd_stop() {
  sudo pkill -f "[e]vsieve.*kbd-no-copilot" || true
  sleep 0.5
  echo "stopped."
}

case "${1:-}" in
  start) cmd_start ;;
  stop) cmd_stop ;;
  *) usage; exit 2 ;;
esac

cd ~/Documents/apps/keyremap
./remap.sh start
# 別ターミナルで:
xinput list | grep -i copilot
# 期待値: kbd-no-copilot が見えるはずです。

xev -event keyboard
# Copilot キー単押しで Control_R の KeyPress/KeyRelease が出れば成功です。
# Super_L / Shift_L / F23 が出なくなっていることも確認します。

./remap.sh stop

[Unit]
Description=keyremap: convert Copilot key chord to RightCtrl via evsieve
After=multi-user.target

[Service]
Type=simple
ExecStart=/home/YOUR_USER/Documents/apps/keyremap/evsieve --input /dev/input/by-id/DEVICE grab --hook key:leftmeta key:leftshift key:f23 sequential period=0.1 send-key=key:rightctrl --withhold --delay key:rightctrl:0 period=0.3 --output name=kbd-no-copilot create-link=kbd-no-copilot
Restart=on-failure
RestartSec=2

[Install]
WantedBy=multi-user.target

# YOUR_USER と DEVICE を置換済みか確認します。
grep -n "ExecStart" ~/Documents/apps/keyremap/keyremap-evsieve.service

sudo install -m 644 ~/Documents/apps/keyremap/keyremap-evsieve.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now keyremap-evsieve.service
systemctl is-active keyremap-evsieve.service
# 期待値: active

systemctl is-active keyremap-evsieve.service
# 期待値: active

xinput list | grep -i copilot
# 期待値: kbd-no-copilot が見える

xev -event keyboard
# Copilotキー単押しが Control_R に見えること
# (Super_L / Shift_L / F23 が出ないこと)

sudo ./evsieve \
  --input /dev/input/by-id/DEVICE grab \
  --hook key:leftmeta key:leftshift key:f23 sequential period=0.1 \
  --withhold \
  --output name="kbd-no-copilot" create-link="kbd-no-copilot"

xev -event keyboard
# Copilotキー単押しで Control_R が出るか確認します。
# Super_L / Shift_L / F23 が残っていたら hook の period を調整します。

ls -l /dev/input/by-id/ | grep -i kbd
ls -l /dev/input/by-path/ | grep -i kbd
sudo dmesg | tail -30
# キーボードを抜き差しして、どの名前で認識されるか見る

sudo systemctl stop keyremap-evsieve.service
# または再起動

sudo systemctl disable --now keyremap-evsieve.service