Quick Answer: WebHID Browser & Wired Mode Rules

Both Web NuPhyIO (nuphy.io, running NuPhyIO 2.0 with a 1.0 toggle) and Web VIA (usevia.app via NuPhy Console) require Google Chrome or Microsoft Edge — Safari and Firefox do not support WebHID. Connect the keyboard directly to your computer with a data-capable USB-C cable and switch the hardware toggle to Wired mode (wireless configuration is unsupported).

1. Which configurator matches your NuPhy model?

Using the wrong web tool or flashing the wrong edition file causes detection failures or broken keymaps.

ConfiguratorSupported NuPhy ModelsNotes
VIA / QMK (NuPhy Console)Air60 V2, Air75 V2, Air96 V2, Kick75 (QMK/VIA), Halo75 V2 (QMK/VIA), Halo96 V2 (QMK/VIA)Load the exact VIA JSON if requested; do not use NuPhyIO
NuPhyIO (2.0 / 1.0 toggle)Air60 HE, Air75 HE, Air75 V3, Air100 V3, Node75 (LP/HP), Node100 (LP/HP), Kick75 (IO), Halo75 V2 (IO), Halo96 V2 (IO)Includes Windows .exe and macOS .zip desktop downloads on firmwareUpdate

2. Fix WebHID keyboard not detected errors

  • Use Google Chrome or Microsoft Edge (desktop). Safari, Firefox and most mobile browsers block WebHID.
  • Set the keyboard hardware switch to Wired mode — NuPhyIO and VIA do not configure keyboards over Bluetooth or 2.4G.
  • Connect directly to a motherboard or laptop USB port using a data-capable USB-C cable; bypass unpowered USB hubs, KVMs and charge-only cables.
  • On nuphy.io, try the NuPhyIO 1.0 toggle or the Windows .exe / macOS .zip desktop client if your firmware predates NuPhyIO 2.0.
  • Close competing RGB or key-remapping software (such as VIA in another tab) so only one WebHID session claims the interface.

3. Firmware & Recovery safety rules

Verify model, edition (IO vs QMK/VIA) and physical layout (ANSI, ISO or JIS) before downloading any firmware file.

NuPhyIO & VIA Setup Questions

Why does NuPhyIO or VIA fail in Safari or Firefox?

Web NuPhyIO and Web VIA rely on the browser WebHID API to talk to USB hardware. Safari and Firefox do not support WebHID, so you must open Chrome or Microsoft Edge.

Can I configure my NuPhy keyboard over Bluetooth or 2.4G?

No. Both NuPhyIO and VIA require a direct wired USB-C data cable connection with the keyboard switch set to Wired mode.

Can I switch a QMK and VIA Kick75 or Halo V2 to NuPhyIO firmware?

No. The QMK and VIA editions and the NuPhyIO editions are separate hardware and firmware ecosystems. Mixing firmware, JSON files or recovery packages is unsupported and risks bricking the board.

What if nuphy.io 2.0 does not detect my NuPhyIO keyboard?

Verify Wired mode, swap to a direct USB-C data cable without hubs, close other VIA or NuPhyIO tabs, and test the NuPhyIO 1.0 toggle or official desktop client.