About sharkfin

sharkfin is free software for keyboards built on ROYUAN hardware. It is maintained by @dniminenn (dnim.dev) and grew out of reverse engineering the boards' USB protocol. The code is GPL-3.0-or-later and lives at github.com/dniminenn/sharkfin. It is a community project, not affiliated with Attack Shark, ROYUAN or any keyboard vendor.

It started with buying one of these keyboards and being immediately frustrated by the software: Windows only, and still a huge packaged Electron app. So the vendor packages piled up, tons and tons of them, until the logic was matched, the holes were filled and the protocol was documented. sharkfin is its own dogfood: the maintainer's boards are configured with it daily.

Where the numbers come from

Every count on this site is generated from the same device registry the app ships, so the pages cannot claim support the app does not have. A board is "writable" when its command set is established; boards whose command set is not established yet are identified and read but never written to. Capability claims, screen drawing included, mirror the exact gates in the app's source.

Privacy

The site and the browser app have no analytics, no accounts, no cookies and no tracking of any kind; the pages even tell the CDN not to inject its own scripts. The browser app makes no network requests once loaded: everything happens between your browser and the USB cable. The site is served by Cloudflare, which sees standard request logs as any host does. There is nothing else to disclose, because nothing else is collected.

In the press

Hackaday: "Sharkfin Bites Attack Shark" · kbd.news: "Sharkfin configurator"

Contact

Bugs, board reports and questions all go through GitHub issues.