Freedom251 › Keyboard and Mouse Customization Software
sharkfin

What sharkfin is
sharkfin is a free, open-source configurator for keyboards built on ROYUAN hardware, including boards sold under Attack Shark, Akko, Epomaker, MonsGeek, Ajazz, Hator, and ikbc brands. It runs on Linux, macOS, Windows, and the web. Users can remap keys across base and Fn layers, including a knob, to keyboard keys, mouse actions, macros, or media controls. Lighting effects and individual key colours are adjustable. Macro recording captures keyboard and mouse sequences with per-event delays and stores them in 50 onboard slots. Magnetic boards can expose actuation and release points, rapid trigger, and dynamic keystroke settings, with some controls requiring Setup. The registry lists 1,386 boards, including 1,149 writable immediately and 204 writable after permission. Settings writes require USB; Bluetooth has no settings channel. Profiles stay on the keyboard, while backups omit macros and per-key paint. The application writes settings, never firmware, and does not handle unknown command sets.
Who it suits
It suits owners of supported ROYUAN-based keyboards who want cross-platform remapping, lighting, macros, or magnetic-switch controls. A USB connection is needed when writing settings.
What it does well
- Free and open source
- Runs on Linux, macOS, Windows, and web
- Supports 50 onboard macro slots
- Offers magnetic-switch adjustments
- No account, analytics, or cookies
What to know first
- No polling-rate controls
- No QMK or VIA support
- Bluetooth has no settings channel
- Backups exclude macros and per-key paint
Plans
| Plan | Billed and limits | Price |
|---|---|---|
| Free | Free keyboard software · GPL-3.0-or-later | Free |
As getsharkfin.com lists them, read 11 Oct 2026. The maker's own page has the final word.
Getting started
- Visit the sharkfin website and choose the web or desktop version for your platform.
- Connect the keyboard by USB to write settings.
- Check whether your board is writable out of the box or requires a command-set request and permission.
- Remap keys, adjust lighting or record macros for supported features.
- Use Setup to unlock applicable magnetic-board controls.
Verdict
sharkfin provides broad keyboard configuration without accounts or firmware changes. Confirm that your board and wireless receiver expose a supported command channel.
Questions
How much does sharkfin cost?
The Free plan costs nothing.
Is sharkfin open source?
Yes. The Free plan is described as GPL-3.0-or-later.
Which platforms does it support?
It runs on Linux, macOS, Windows and the web.
Which keyboards does it support?
It is for keyboards built on ROYUAN hardware. Its registry lists 1,386 boards, including writable boards and some that require a command-set request and permission.
Can it configure Bluetooth settings?
No. Bluetooth has no settings channel; settings writes require USB, while wireless access through a 2.4 GHz receiver depends on whether it relays that channel.
Does it write firmware?
No. sharkfin writes keyboard settings, not firmware, and does not write to boards with an unknown command set.
Facts from sharkfin's own pages
- Backups
- Backup files include keymaps, lighting and settings, but exclude macros and per-key paint; profiles are stored on the keyboard. · getsharkfin.com, 11 Oct 2026
- Connection requirement
- Writes require a USB cable; Bluetooth has no settings channel, and wireless access through a 2.4 GHz receiver depends on whether it relays that channel. · getsharkfin.com, 11 Oct 2026
- Free plan
- Yes · getsharkfin.com, 22 Sept 2026
- Key mapping
- It lets users remap keys to keyboard keys, mouse actions, macros or media controls across base and Fn layers, including the knob. · getsharkfin.com, 11 Oct 2026
- Lighting
- Users can adjust the keyboard's built-in lighting effects and paint individual keys with custom colours. · getsharkfin.com, 11 Oct 2026
- Limits
- It does not offer report or polling rate settings, QMK or VIA support, Bluetooth settings, or music-synchronized lighting; it says some of these require different firmware or a continuously running program. · getsharkfin.com, 11 Oct 2026
- Macros
- It can record key and mouse sequences with per-event delays into 50 onboard slots and bind them to keys. · getsharkfin.com, 11 Oct 2026
- Macro support
- Yes · getsharkfin.com, 22 Sept 2026
- Magnetic switches
- On magnetic boards, it offers settings such as actuation and release points, rapid trigger and dynamic keystroke, with some controls requiring Setup to unlock. · getsharkfin.com, 11 Oct 2026
- Maintainer and history
- The maker identifies @dniminenn as maintainer and says the first release was 26 July 2026; it does not state an HQ or founding date. · getsharkfin.com, 11 Oct 2026
- Onboard device memory
- Yes · getsharkfin.com, 22 Sept 2026
- Platforms
- Downloads are offered for Linux, macOS and Windows, and a browser version runs in Chrome, Edge or another Chromium browser; Firefox and Safari cannot open the keyboard. · getsharkfin.com, 11 Oct 2026
- Polling rate control
- No · getsharkfin.com, 22 Sept 2026
- Privacy
- The browser build makes no requests of its own after loading, the desktop app makes no network requests, and the app has no account, analytics or cookies. · getsharkfin.com, 11 Oct 2026
- Purpose
- sharkfin is an 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. · getsharkfin.com, 11 Oct 2026
- Safety
- sharkfin writes keyboard settings but never firmware, and it does not write to a board whose command set is unknown. · getsharkfin.com, 11 Oct 2026
- Support
- Bugs and questions go through GitHub issues, and users can submit a board report with a photo to help add keyboard support. · getsharkfin.com, 11 Oct 2026
- Supported boards
- The home page lists 1,386 boards in its registry, including 1,149 writable out of the box and 204 whose command set is requested at connection and writable after permission. · getsharkfin.com, 11 Oct 2026
- Supported operating systems
- cross-platform · getsharkfin.com, 22 Sept 2026