wine-hid-device-tools

Wine HID Device Tools

Hermes: все команды и скрипты этого скилла — обычный bash, запускай через terminal. Вывод команд показывай пользователю как есть.

Goal

Help users run Windows keyboard and HID vendor tools on Linux when the device works as normal input but the configuration app cannot detect or control it. Diagnose Linux USB/HID visibility, hidraw permissions, the correct Wine prefix, and winebus settings before recommending a Windows VM.

Do not run Wine as root. Do not assume ~/.wine is the correct prefix.

Quick Workflow

1. Confirm the device is wired over USB data, not only charging or still using Bluetooth/2.4 GHz.
2. Find the device's VID/PID and hidraw nodes.
3. Verify user access to the relevant /dev/hidraw* nodes.
4. Generate and apply a udev rule if permissions are missing.
5. Find the prefix that contains the installed vendor app.
6. Apply winebus settings to that exact prefix.
7. Relaunch the installed .exe with careful shell quoting.

Use scripts first when available; they are read-only except for printing commands.

Discovery Scripts

List HID raw devices:

scripts/discover_hid_devices.sh
scripts/discover_hid_devices.sh 'aula|sonix|keyboard|0c45'

Find likely Wine prefixes and installed vendor executables:

scripts/find_wine_prefix_apps.sh
scripts/find_wine_prefix_apps.sh 'aula|akko|keychron|keyboard|driver'

Print setup commands for a known VID/PID:

scripts/print_hid_setup_commands.sh 0c45:800a
scripts/print_hid_setup_commands.sh 0c45:800a "/path/to/prefix"

The third script prints commands only. Review them with the user before applying sudo or registry changes.

Manual HID Checks

Use these when scripts are unavailable or more detail is needed:

lsusb
sudo dmesg -wH | grep -Ei --line-buffered 'usb|hid|hidraw|keyboard|device'

Inspect hidraw metadata:

for d in /sys/class/hidraw/hidraw*; do
  [ -r "$d/device/uevent" ] || continue
  echo "/dev/${d##*/}"
  cat "$d/device/uevent"
  echo
done