sharkfin

What sharkfin is

sharkfin is a free, open-source configurator for keyboards built on ROYUAN hardware, including models sold under brands such as Attack Shark, Akko, Epomaker, MonsGeek, Ajazz, Hator, and ikbc. It runs on Linux, macOS, Windows, and the web. Users can remap keys across base and Fn layers, including the knob, to keyboard keys, mouse actions, macros, or media controls. It also adjusts built-in lighting and supports custom colours on individual keys.

Macro recording captures key and mouse sequences with per-event delays; recordings can be assigned to keys and stored in 50 onboard slots. Magnetic keyboards offer settings such as actuation and release points, rapid trigger, and dynamic keystroke, though some controls require Setup to unlock. Profiles are stored on the keyboard. Backup files include keymaps, lighting, and settings but omit macros and per-key paint. Settings writes require a USB cable: Bluetooth has no settings channel, and 2.4 GHz access depends on whether the receiver relays it. The maker's registry lists 1,386 boards, and the software writes keyboard settings but not firmware.