rongyuan GGDJ104 keyboard software
Remap keys, set the RGB, record macros and change device settings on the rongyuan GGDJ104. 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 GGDJ104 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 GGDJ104
- 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.
- Debounce. Adjustable, 1 to 10.
- Sleep timers for 2.4 GHz and Bluetooth, plus deep sleep.
- The knob. Turn left, turn right and press are all remappable. From the factory: volume down, mute, volume up.
- Backup. Export everything to a file and restore it later.
- Screen. Some revisions have one (device 3685). sharkfin does not upload images to it; the firmware does not answer those commands.
sharkfin draws the GGDJ104 key by key, so you remap on a picture of your own board.
GGDJ104 at a glance
| Brand | rongyuan |
| Model | GGDJ104 |
| USB ID | 3151:5056 |
| Device ID | 3418, 3685 |
| Protocol family | gen2 |
| Settings writable | yes |
| Drawn layout | yes |
| Onboard profiles | 4 |
Connecting
Plug the GGDJ104 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.
GGDJ104 revisions
| Device ID | USB ID | Controller | Family | Writable | Layout |
|---|---|---|---|---|---|
| 3418 | 3151:5056 | ry6602_ggdj104_3m_1k_1k | gen2 | yes | drawn |
| 3685 | 3151:5056 | ry6602_hc_gdjj104_3m_1k_1k | gen2 | yes | drawn |