chimera-mapper
October 2026
The Kreo Chimera V1 ships with Windows-only software. On Linux and macOS the extra buttons do nothing, you can't change DPI, and the RGB just cycles. chimera-mapper is the result of reverse engineering the mouse's USB protocol and rebuilding everything the vendor app does, packed into a lightweight desktop GUI that runs on Linux and macOS.
What it does
Everything the stock software does, without the stock software. Button remapping, six-stage DPI sensitivity, polling rate, RGB lighting modes, and a macro editor, all talking directly to the mouse over USB HID.
How it got here
It started as a tiny loop: read HID reports, watch one byte, fire key events when the side buttons flip. That was enough to get browser-back and browser-forward working on Linux.
But once I had the HID pipe open both ways, the rest of the protocol was right there. The mouse accepts feature reports that change its configuration: DPI tables, button bindings, polling rate, lighting. All in a few-byte format that the vendor app builds and sends. I captured those packets, mapped out the structure, and wrote the other side.
The protocol
The mouse communicates through feature reports on a specific HID interface. Each report starts with a report ID that selects the subsystem (sensitivity, buttons, lighting, macros), followed by a compact binary payload.
Sensitivity is a set of preset slots, each holding a DPI value and an optional per-axis colour. Button bindings encode the action type (mouse button, key combo, macro index, DPI cycle, media control, or disabled) and up to a keyboard shortcut's worth of modifiers and scancodes. Lighting is a mode selector (rainbow, neon, flash, show) plus speed and brightness. Macros are sequences of keystroke events with inter-event delays, stored in the mouse's onboard memory.
Writing a config is a feature report set; reading it back is a feature report get. The mouse ACKs by echoing the report ID.
The GUI
The interface is split in two: a visual map of the mouse on the left (click a button to remap it) and the settings panel on the right (DPI stages, polling rate, lighting, macros). The remap dialog gives you everything the protocol supports (mouse buttons, navigation, media, DPI control, macros, keyboard shortcuts, or disable) in one flat list so you don't have to guess what's available.
Battery level and cable/wireless status read from a separate report and sit in the top bar.
Why it's built this way
I wanted something I could forget is running. No daemon, no tray icon, no autostart. You open it, change what you want, close it. The config lives in the mouse. The tool is just a window into it.
It's only been tested on the Kreo Chimera V1, because that's the mouse on my desk. The protocol structure would likely cover other mice from the same OEM, but I'm not going to claim that without testing.