<!-- Generated by vite-plugin-geo; source: en/guides/nuphyio-via-setup/index.html -->

# NuPhyIO 2.0 vs VIA Setup & WebHID Troubleshooting Guide

> Check whether your NuPhy keyboard uses NuPhyIO 2.0 or VIA, fix Chrome/Edge WebHID USB-C detection issues, and avoid mixing Kick75 or Halo V2 edition files.

## 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.

Configurator

Supported NuPhy Models

Notes

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

Dual-Edition Warning: Kick75, Halo75 V2 and Halo96 V2 each exist in BOTH a NuPhyIO (IO) edition and a QMK/VIA edition. Keymaps, VIA JSONs, firmware and recovery files are NOT interchangeable. Also note Weikav NUT75 is not a NuPhy board and uses Weikav’s own driver.

## 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.

Never reset or flash firmware if the battery is swelling, overheating, or physically damaged, or if your keyboard is stuck in Bootloader / Recovery mode — follow the official Recovery procedure for your exact edition or contact NuPhy support.

## Models covered by NuPhyIO & VIA

[Kick75](/en/keyboards/kick75/)[Halo75 V2](/en/keyboards/halo75-v2/)[Halo96 V2](/en/keyboards/halo96-v2/)[Air75 V3](/en/keyboards/air75-v3/)[Air100 V3](/en/keyboards/air100-v3/)[Node75 Low-Profile](/en/keyboards/node75-lp/)

## Setup & troubleshooting guides

[Bluetooth & 2.4G Pairing](/en/guides/bluetooth-pairing/)[Backlight & RGB Control](/en/guides/backlight-rgb/)[Battery & LED Indicators](/en/guides/battery-indicator/)[Reset & Sleep Troubleshooting](/en/guides/reset-sleep-troubleshooting/) [Guides](/en/guides/)

## 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.
