Custom Vial + SOCD + OpenRGB (offset) firmware and Linux host tools for the wired Royal Kludge R75 (VID:PID 342d:e484).
Stock “VIA” on these boards is a locked-down OEM build. This remaster turns the same PCB into a full Vial keyboard with CS2-friendly SOCD and PC-driven RGB (including a real cava bar visualizer on the key matrix).
Risk: Flashing custom firmware can soft-brick until DFU recovery. Always backup first. Esc-hold on plug-in enters bootloader (and clears EEPROM).
- Vial — layers, tap dance (via app), combos, macros, VialRGB
- SOCD cleaner — WASD last-win, toggleable (
SOCDTOG) - OpenRGB offset protocol (
0x20) — host RGB without killing Vial’s RAW HID - Linux host visualizers — cava spectrum/bars/beat modes over HID
- Safety — stock dumps, restore images, DFU scripts
# Build
./scripts/build.sh
# Backup (keyboard must be in DFU)
./scripts/backup-stock.sh
# Flash (explicit confirmation required)
./scripts/flash.sh firmware/r75-vial-socd-openrgb.bin --yesFull DFU / restore notes: docs/FLASH.md
OpenRGB / cava notes: docs/OPENRGB.md
Host packages: docs/HOST_APPS.md
| Method | How |
|---|---|
| Software | Fn + Right Shift + Q (QK_BOOT on CTL layer) |
| Hardware | Unplug → hold Esc → plug in (also erases EEPROM) |
| Vial | Security → Enter bootloader |
| Action | Binding |
|---|---|
| CTL (config) layer | Hold Fn + Right Shift |
| Bootloader (DFU) | CTL + Q |
| Clear EEPROM | CTL + Z |
| Toggle SOCD | CTL + T |
| Toggle NKRO | CTL + N |
| Vial unlock | Esc + Enter |
Configure everything else in the Vial app (not the old VIA Design JSON).
Close Vial first (same RAW HID interface).
python host/openrgb_probe.py # should print OpenRGB offset 0x0e
python host/audio_reactive_rgb.py --list
python host/audio_reactive_rgb.py --mode cava
python host/audio_reactive_rgb.py --mode beat
python host/audio_reactive_rgb.py --mode cava-peak --sensitivity 1.4Also: host/cpu_heat_rgb.py (CPU → color wash).
overlay/ remaster sources (tracked) — applied onto vial-qmk at build
backups/ stock-from-device.bin, Original-Firmware.hex, …
firmware/ r75-vial-socd-openrgb.bin|.hex
host/ cava visualizer, probes, configs
scripts/ build, backup, flash
docs/ FLASH, OPENRGB, HOST_APPS
udev/ QMK/WB32 udev rules
vendor/ local clones only (gitignored — do not push)
vendor/ is not committed (vendor/vial-qmk ≈ 1.6GB). ./scripts/build.sh clones vial-qmk / wb32 tools if missing and applies overlay/.
This remaster stands on a lot of prior work. Huge thanks to the people and projects below — please star / support their repos.
| Project / person | Role |
|---|---|
| sdk66 | Original Hangsheng / RK R75 QMK tree |
| iamdanielv (kb_rk_r65) | R65 customization this port descends from |
| irfanjmdn (r65) | Earlier R65 QMK / Vial work |
| boa / mossbed (boafur) | R75 VialRGB port + matrix/RGB fixes we based on |
| snakkarike/Royal-Kludge-R75 | SOCD integration, stock hex backup, OpenRGB/SignalRGB R75 variants |
| Project | Role |
|---|---|
| vial-kb/vial-qmk | Vial-enabled QMK fork (build tree) |
| getreuer / SOCD Cleaner | SOCD filtering library (via snakkarike’s packaging) |
| reelmesh/openrgb-gmmk2-p96-iso | OpenRGB↔Vial offset protocol approach adapted here |
| WestberryTech/wb32-dfu-updater | WB32 DFU flash / dump CLI |
| QMK | Firmware framework |
| cava | Desktop audio spectrum fed into host/audio_reactive_rgb.py |
- Royal Kludge / RK — R75 board
- Hangsheng — OEM controller platform (
342d:e484)
If we missed a credit you care about, open an issue or PR and we’ll fix it.
Custom firmware can damage or temporarily brick devices. You flash at your own risk. Keep backups/stock-from-device.bin and/or backups/Original-Firmware.hex before experimenting.
Remastered for Linux-first use. Built, not bought.