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

# NuPhyIO 2.0 vs. VIA Einrichtung & WebHID Fehlerbehebung

> Prüfen Sie, ob Ihre NuPhy-Tastatur NuPhyIO 2.0 oder QMK/VIA nutzt, lösen Sie Chrome/Edge-WebHID-USB-C-Erkennungsprobleme und vermeiden Sie Mischdateien bei Kick75 oder Halo V2.

## Kurzantwort: WebHID-Browser & Kabelmodus

Sowohl Web NuPhyIO (nuphy.io, NuPhyIO 2.0 mit 1.0-Umschalter) als auch Web VIA (usevia.app über NuPhy Console) setzen Google Chrome oder Microsoft Edge voraus – Safari und Firefox unterstützen kein WebHID. Verbinden Sie die Tastatur direkt über ein datenfähiges USB-C-Kabel mit Ihrem Computer und stellen Sie den Hardwareschalter auf Kabelmodus (kabellose Konfiguration wird nicht unterstützt).

## 1\. Welcher Konfigurator passt zu Ihrem NuPhy-Modell?

Das falsche Web-Tool oder die falsche Editions-Datei führt zu Erkennungsfehlern oder beschädigten Tastenbelegungen.

Konfigurator

Unterstützte NuPhy-Modelle

Hinweise

VIA / QMK (NuPhy Console)

Air60 V2, Air75 V2, Air96 V2, Kick75 (QMK/VIA), Halo75 V2 (QMK/VIA), Halo96 V2 (QMK/VIA)

Bei Bedarf exakt passende VIA-JSON laden; nicht mit NuPhyIO öffnen

NuPhyIO (2.0 / 1.0 Schalter)

Air60 HE, Air75 HE, Air75 V3, Air100 V3, Node75 (LP/HP), Node100 (LP/HP), Kick75 (IO), Halo75 V2 (IO), Halo96 V2 (IO)

Inklusive Windows-.exe- und macOS-.zip-Desktop-Clients auf firmwareUpdate

Dual-Edition-Warnung: Kick75, Halo75 V2 und Halo96 V2 gibt es jeweils als NuPhyIO-(IO-)Edition UND als QMK/VIA-Edition. Keymaps, VIA-JSONs, Firmware und Recovery-Dateien sind NICHT austauschbar. Hinweis: Weikav NUT75 ist keine NuPhy-Tastatur und nutzt den eigenen Weikav-Treiber.

## 2\. Fehler „Tastatur in WebHID nicht erkannt“ beheben

- Verwenden Sie Google Chrome oder Microsoft Edge am Desktop. Safari, Firefox und die meisten mobilen Browser blockieren WebHID.
- Stellen Sie den Hardwareschalter der Tastatur auf Kabelmodus (Wired) – über Bluetooth oder 2,4 GHz ist keine Web-Konfiguration möglich.
- Verbinden Sie die Tastatur direkt per datenfähigem USB-C-Kabel mit einem Mainboard- oder Laptop-USB-Port; verzichten Sie auf passive USB-Hubs, KVMs und reine Ladekabel.
- Falls Ihre Firmware älter als NuPhyIO 2.0 ist, testen Sie auf nuphy.io den Schalter für NuPhyIO 1.0 oder den offiziellen Windows-.exe- bzw. macOS-.zip-Client.
- Schließen Sie konkurrierende RGB- oder Keymap-Tabs (z. B. ein zweites VIA-Fenster), damit immer nur eine WebHID-Sitzung auf das Gerät zugreift.

## 3\. Sicherheitsregeln für Firmware & Recovery

Prüfen Sie vor jedem Firmware-Download Modell, Edition (IO vs. QMK/VIA) und physisches Layout (ISO-DE, ANSI oder JIS).

Setzen Sie die Tastatur niemals zurück und flashen Sie keine Firmware, wenn der Akku aufgebläht, überhitzt oder physisch beschädigt ist oder das Gerät im Bootloader-/Recovery-Modus feststeckt – folgen Sie in diesem Fall nur dem offiziellen Recovery-Verfahren Ihrer exakten Edition.

## Modelle mit NuPhyIO & VIA

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

## Einrichtungs- & Fehlerbehebungs-Ratgeber

[Bluetooth & 2,4-GHz-Pairing](/de/guides/bluetooth-pairing/)[Beleuchtung & RGB-Steuerung](/de/guides/backlight-rgb/)[Akku- & LED-Anzeigen](/de/guides/battery-indicator/)[Reset & Ruhemodus](/de/guides/reset-sleep-troubleshooting/) [Ratgeber](/de/guides/)

## Häufige Fragen zu NuPhyIO & VIA

Warum funktionieren NuPhyIO oder VIA nicht in Safari oder Firefox?

Web NuPhyIO und Web VIA kommunizieren über die Browser-Schnittstelle WebHID mit der USB-Hardware. Da Safari und Firefox WebHID nicht unterstützen, müssen Sie Google Chrome oder Microsoft Edge nutzen.

Kann ich meine NuPhy-Tastatur über Bluetooth oder 2,4 GHz konfigurieren?

Nein. Sowohl NuPhyIO als auch VIA verlangen eine direkte Verbindung per datenfähigem USB-C-Kabel bei aktiviertem Kabelmodus.

Kann ich eine Kick75 oder Halo V2 mit QMK und VIA auf NuPhyIO umflashen?

Nein. Die QMK- und VIA-Editionen sowie die NuPhyIO-Editionen bilden getrennte Hardware- und Firmware-Systeme. Das Mischen von Firmware, JSON-Dateien oder Recovery-Paketen ist nicht unterstützt und kann das Gerät unbrauchbar machen.

Was tun, wenn nuphy.io 2.0 meine NuPhyIO-Tastatur nicht findet?

Prüfen Sie den Kabelmodus, schließen Sie ein datenfähiges USB-C-Kabel ohne Hub direkt an den Rechner an, beenden Sie andere VIA- oder NuPhyIO-Tabs und testen Sie den NuPhyIO-1.0-Schalter oder den Desktop-Client.
