Use a Chromium Browser

nuphy.io talks to the keyboard through a browser feature called WebHID.

Chromium, Google Chrome, Microsoft Edge, and other Chromium browsers support WebHID. Firefox-based browsers do not.

Granting the Browser Access to the Keyboard

WebHID reaches the keyboard through its raw device file, /dev/hidraw*. By default, only the system administrator account can read these files, so the browser cannot open them.

A udev rule fixes this. A udev rule is a system file that tells Linux how to treat a device the moment it is plugged in.

• Create the rule file

  sudo $EDITOR /etc/udev/rules.d/70-nuphy.rules

  This creates and opens a new file, write the following to it:

  /etc/udev/rules.d/70-nuphy.rules

  KERNEL=="hidraw*", ATTRS{idVendor}=="19f5", MODE="0660", TAG+="uaccess"

  Technical details...

  • KERNEL=="hidraw*" applies the rule to raw device files opened by WebHID.
  • ATTRS{idVendor}=="19f5" narrows it to devices made by NuPhy. 19f5 is the number assigned to NuPhy for USB devices, so nothing else on your machine is affected.
  • MODE="0660" allows browser to both read and write.
  • TAG+="uaccess" hands the access to a person logged in to the machine.

• Unplug and re-plug your keyboard.

Contributors

aier9500

Changelog

8/31/26, 8:46 PM

View All Changelog

• 5cce1-Nuphy guide to allow browser to edit keyboard via nuphyioon 8/31/26