WraithLinux

KO | EN

gitlite — search

#llm #go #android #machine-learning #rust #docker #nodejs #java #awesome #awesome-list #pytorch #security #openai #ios

(★ 9)

Linux rules apply to the Wraith W75 and W1; the web drivers don't work on Linux.

WraithLinux Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# WraithLinux — udev Rules for Wraith W75 & Pixart W1 on Linux

> **An open call to Wraith Esports.** This project exists because the
> official Wraith configurator is shipped only as a domain-locked WebHID
> bundle, with no Linux support and no published protocol. Linux users who
> already own your hardware are stuck reverse-engineering the JavaScript
> client just to change an RGB color or tune the actuation point on a
> keyboard they paid for. **Please consider open-sourcing your device
> drivers, protocol documentation, or at the very least the configuration
> client.** Even a permissively licensed reference implementation would let
> the community build proper native tooling (libratbag/Piper-style daemons,
> GNOME/KDE settings panels, OpenRGB plugins) and turn your products into
> first-class citizens on every desktop OS. Maintainers and engineers at
> Wraith: PRs, contact, or a public spec drop are very welcome — open an

A tiny helper that lets Chrome/Chromium-based browsers talk to the
**Wraith Esports W75** keyboard and **Pixart W1 Freestyle** mouse over the
**WebHID API** on Linux.

When a browser tries to open a HID device via WebHID, Linux exposes
`/dev/hidraw*` nodes as `root`-only by default, so the configuration software
fails with:

```
NotAllowedError: Failed to open the device
```

A single shell script installs udev rules that grant `MODE=0666` and
`TAG+="uaccess"` to the relevant USB IDs, permanently fixing the issue.

## Supported Devices

| Device              | USB ID      | Notes                                              |
| ------------------- | ----------- | -------------------------------------------------- |
| Wraith Esports W75  | `2e3c:c365` | Hall-effect magnetic keyboard                      |
| Pixart W1 Freestyle | `093a:522c` | `093a` is a shared OEM VID — scoped by `idProduct` |

## Installation

Copy and paste this into your terminal:

```bash
curl -fsSL https://raw.githubusercontent.com/Oztturk/WraithLinux/main/install-udev-rules.sh | sudo bash
```

That's it. No clone, no manual download.

Prefer a two-step approach? Same result:

```bash
curl -fsSLO https://raw.githubusercontent.com/Oztturk/WraithLinux/main/install-udev-rules.sh
chmod +x install-udev-rules.sh
sudo ./install-udev-rules.sh
```

You can also grab `install-udev-rules.sh` from the
[Releases](https://github.com/Oztturk/WraithLinux/releases) page and run it the
same way.

The script:

1. Writes `/etc/udev/rules.d/99-wraith-w75.rules`.
2. Writes `/etc/udev/rules.d/99-w1-mouse.rules`.
3. Reloads rules with `udevadm control --reload-rules`.
4. Sends a `change` event to existing `hidraw` and `usb` nodes via
   `udevadm trigger` so permissions update immediately.

The standalone `.rules` files in this repo are kept for reference — the
installer embeds their content, so it has no runtime dependency on them.

## After Installing

1. Close every open Chrome/Chromium/Brave/Edge tab.
2. Unplug the keyboard / mouse, wait ~2 seconds, plug it back in.
3. Reopen the browser and connect from the configuration software.

Verify with:

```bash
ls -l /dev/hidraw*
getfacl /dev/hidrawN   # replace N with the node you care about
```

You should see `crw-rw-rw-` or a `user:<your-user>:rw-` ACL entry.

## Troubleshooting

- Open `chrome://device-log/`, filter by `HID`, and watch the connection
  attempt. If you still see `Failed to open` instead of `Opened device`, the
  rules did not apply.
- `udevadm info -a -n /dev/hidrawN | grep -E 'idVendor|MODE|TAG'` shows
  whether the rule actually matched that node.
- Clear old grants under `chrome://settings/content/hid` and reauthorize the
  device — stale permission records sometimes confuse the picker.

## Notes

- **Firefox** does not currently support WebHID; installing these rules will
  not change that.
- The rules match on USB VID/PID, so they work identically for every user who
  owns the same hardware — there is no per-user configuration.
- Thanks to `TAG+="uaccess"`, the locally logged-in user automatically gets an
  ACL on the device; no `plugdev` or `input` group membership required.

## Uninstall

```bash
sudo rm /etc/udev/rules.d/99-wraith-w75.rules /etc/udev/rules.d/99-w1-mouse.rules
sudo udevadm control --reload-rules
sudo udevadm trigger
```

## License

Personal-use tool. Use, modify, and redistribute as you like.

WraithLinux

WraithLinux Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

WraithLinux

WraithLinux Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README