Skip to main content

Kludge Knight

Themes by tweakcn:

Open source Royal Kludge software
for Mac, Linux, and Windows

Remap keys and configure lighting in your browser — no installation required

Unofficial software, not affiliated with Royal Kludge.
Built through reverse engineering and referencing other works like Rangoli.

View Source on GitHub
or
Features

Remap Any Key

Map any key to any other key or modifier. Changes are written directly to keyboard firmware.

Control Lighting

Set backlight brightness, speed, and effects. Works with both standard and RGB models.

Runs in Browser

Uses WebHID API. Works in Chrome, Edge, and Opera. No drivers or admin permissions needed.

Cross-Platform

Works across Windows, Mac, and Linux. Settings saved in browser storage.

Everything Runs Locally

Hosted as a static site on GitHub Pages with no backend. All configuration happens directly between browser and keyboard via WebHID. Settings stored in browser localStorage only.

Instructions
  1. 1Connect Royal Kludge keyboard via USB (Bluetooth not supported)
  2. 2Click Connect Keyboard button
  3. 3Select keyboard from browser dialog and click Connect
Feature Stability
STABLE

Key Mapping

Tested on RK F68 and S70 Split. Stable for keyboards up to 70 keys with 2 spacebars. Keyboards with other unique modifier keys may be untested.

STABLE

Lighting & RGB Controls

Keyboard-wide lighting and RGB controls tested on RK F68 and S70 Split with extensive RGB functionality. Should work on most devices.

FUTURE

Per-Key RGB

Individual key RGB customization is not yet implemented. Pull requests welcome!

Limitations
  • Can't read existing mappings from keyboard

    RK firmware only accepts writes. KludgeKnight starts with default layout and can only save mappings to browser localStorage.

  • Settings only saved in browser localStorage

    Since keyboard firmware can't be read, settings are saved to browser localStorage as a fallback. No backend means these stay local to one browser. Clearing browser data or switching browsers resets to defaults.

Supported Models

195 RK keyboard models supported.

Configurations from official RK Windows software (Oct 2025).

License

Kludge Knight - Browser-based Software for Royal Kludge Keyboards

Copyright (C) 2025 Vince Mi (vinc3m1)

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.