ROYUAN KF068 keyboard software
Remap keys, set the RGB, record macros and change device settings on the ROYUAN KF068. Free and open source. Use it in a Chromium browser with nothing to install, or download the desktop app for Windows, macOS or Linux. Either way it runs entirely on your own machine: no account, and the browser version makes no network requests once the page has loaded.
2 revisions of the KF068 ship under this name. They are on different controllers, so they are genuinely different hardware and not just a firmware bump. sharkfin does not ask you which one you have: the board reports its own device ID when it is plugged in, and the right command set follows from that.
What sharkfin does with the KF068
- Remap any key. Click a key on a picture of the board and give it another key, a mouse button, cursor movement, the scroll wheel, a macro or a media control. Base and Fn layers both. 4 onboard profiles.
- Lighting. 18 backlight effects with direction options, full RGB colour, brightness and speed, changing live as you drag.
- Per-key colour. Paint individual keys and send the pattern to the board's flash.
- Macros. Record key and mouse sequences with per-event delays into the 50 onboard slots, then bind a key to one.
- Device settings. Windows-key lock, WASD and arrow-cluster swap, backlight off, host-OS auto-detect and a factory reset, all from the Device page.
- Backup. Export everything to a file and restore it later.
- Magnetic switches. This board has them. sharkfin does not configure actuation or rapid trigger: the firmware does not answer those commands. Everything else on this page still works.
sharkfin has no drawn layout for the KF068 yet, so it shows a grid of the board's 128 matrix slots instead. Everything still works; only the picture is missing. You can fix that for everyone: draw the board on keyboard-layout-editor.com, paste the drawing into the app's Keys page, and send the result back.
KF068 at a glance
| Brand | ROYUAN |
| Model | KF068 |
| USB ID | 3151:5029 |
| Device ID | 2278, 2338 |
| Protocol family | gen2 |
| Settings writable | yes |
| Drawn layout | no, shown as a slot grid |
| Onboard profiles | 4 |
gen2 and yc500 are the two command sets ROYUAN firmware speaks. They reuse the same opcode numbers for different commands, so sharkfin never guesses: the board names itself when it is plugged in, and the command set follows from sharkfin's registry, not from the USB id.
Connecting
Plug the KF068 in with a USB cable. There is no configuration channel over 2.4 GHz or Bluetooth on this hardware, so a receiver or a Bluetooth pairing will not do. Settings are stored on the keyboard itself, so everything you change keeps working wirelessly once you unplug. sharkfin never flashes firmware, so there is nothing here that can brick the board. On Linux, both the browser and the app need a one-line udev rule before they can open the keyboard. And if you are hunting for a polling-rate or report-rate setting: there is none in sharkfin, because this hardware does not expose one.
If the KF068 stops responding
It happens: the firmware stops answering and the app says the board needs a replug. Typing keeps working the whole time. In order:
- Close sharkfin, or the browser tab. While either is open it keeps trying to reach the board.
- Unplug the cable, wait ten seconds, plug it back in. The board needs to lose power, not just reconnect.
- Fn + Home turns the lighting back on if the backlight looks dead.
- Fn + Esc, held for about three seconds, resets the board's settings.
- Still wrong? Open sharkfin and use Device, then Factory reset.
None of this touches firmware; nothing here can leave the KF068 unusable.
KF068 revisions
| Device ID | USB ID | Controller | Family | Writable | Layout |
|---|---|---|---|---|---|
| 2278 | 3151:5029 | ry5088_xs_kf068_dm_8k | gen2 | yes | slot grid |
| 2338 | 3151:5029 | ry5088_xs_2338 | gen2 | yes | slot grid |