Boards

VKMS keyboard software

sharkfin is a free, open-source replacement for the VKMS app: remap keys, set the RGB, paint per-key colour and record macros on 21 VKMS boards, 21 of which accept changes. Use it in a Chromium browser with nothing to install, or as an app on Windows, macOS and Linux. It runs entirely on your own machine, with no account.

Does sharkfin support my VKMS board?

The table lists every VKMS model sharkfin knows, 21 in all. If yours is missing, plug it in anyway: these boards report their own device id, and sharkfin identifies anything built on ROYUAN hardware from that reply, works out which command set it speaks, and asks before it writes.

BoardWritableLayout
MAG75 Maxyesdrawn
Mecha 75yesafter a one-time check
NB68yesafter a one-time check
NB68 Maxyesafter a one-time check
VK 75 Maxyesafter a one-time check
VK 75 PROyesafter a one-time check
VK 87 Max V2yesdrawn
VK 87 V2yesdrawn
VK 99 MAXyesafter a one-time check
VK Cyber 68yesafter a one-time check
VK Cyber 68PROyesafter a one-time check
VK MAG 68yesafter a one-time check
VK MAG 68 Maxyesafter a one-time check
VK MAG 75yesdrawn
VK MAG68yesslot grid
VK MAG75 Liteyesslot grid
VK MAG75 Proyesdrawn
VK NB 68 Maxyesafter a one-time check
VK99yesslot grid
VK99 Gamingyesdrawn
VK99 Ultrayesafter a one-time check

"Writable" means sharkfin will change settings on it. Read-only boards are ones whose command set is not established yet; sharkfin identifies them and reads from them, but refuses to write, because the two protocol families in this hardware share opcodes that mean different things. "After a one-time check" means the picture exists but is confirmed against your own board first: two boards can share one picture and still disagree about which internal slot a key lives in, so sharkfin trusts the keyboard over its own files.