Independent lighting control for the HyperX Mars keyboard (VID 0951, PID 16C6). Neo Genesis communicates directly with the device over HID on Windows and Linux; it does not require HyperX Genesis, NGENUITY, a bridge, or any external DLL.

Features

• RGB Wave, Color Loading, Solid, Color Cycle, and Heartbeat effects;
• brightness, speed, direction, and repeat when supported by the firmware;
• ten local profiles;
• per-key and LED-bar custom paint;
• live change tracking — every edit shows as a before → after diff with one-click revert, dirty badges on effects and profiles, and a paint diff (+ added / − removed / ~ recolored) since the last apply;
• an event console with timestamped history of device checks, saves, and applies;
• desktop shortcuts: Ctrl+S saves the profile, Ctrl+Enter writes to the keyboard;
• direct write to onboard keyboard memory;
• keepalive to keep the Heartbeat effect moving.

Usage

1. Close any other programs that may be controlling the keyboard.
2. Open src-tauri\target\release\neo-genesis.exe on Windows or src-tauri/target/release/neo-genesis on Linux.
3. Choose an effect or paint keys on the Custom per key card.
4. Click Apply on Mars or Apply per key.

Do not disconnect the keyboard while a write is in progress. For the Heartbeat effect, keep Neo Genesis open or minimized — the firmware relies on the app's keepalive.

Windows development

Prerequisites: Node.js, stable Rust, Visual Studio C++ tools, and the WebView2 Runtime.

npm install
npm run tauri dev

Local checks:

npm test
npm run build
cargo check --manifest-path src-tauri\Cargo.toml
cargo test --manifest-path src-tauri\Cargo.toml

Production build:

npm run tauri build

The executable lands at src-tauri\target\release\neo-genesis.exe. Windows may show a warning because the binary is not digitally signed. The WebView2 Runtime is typically already present on Windows 10 and 11.

Linux

Install the build prerequisites on Debian or Ubuntu:

sudo apt install libwebkit2gtk-4.1-dev libgtk-3-dev librsvg2-dev libudev-dev build-essential

To grant the active desktop user access to the keyboard's hidraw interface, install the included udev rule and then reconnect the keyboard:

sudo ./packaging/linux/install-udev-rules.sh

Install the JavaScript dependencies and run the app in development:

npm install
npm run tauri dev

Run the local checks and create a production build with:

npm test
npm run build
cargo check --manifest-path src-tauri/Cargo.toml
cargo test --manifest-path src-tauri/Cargo.toml
npm run tauri build

The executable lands at src-tauri/target/release/neo-genesis, and npm run tauri build also produces .deb, .rpm, and AppImage bundles under src-tauri/target/release/bundle/. Pass --bundles deb to build just one of them. The Debian package installs the udev rule automatically; AppImage users must run the rule installation script above.

Known Limitations

• Support is specific to the HyperX Mars 0951:16C6.
• Only lighting is implemented; macros, remapping, and game mode are not part of the app.
• Custom-mode colors are saved locally and are not separated by profile.

This project is not affiliated with or endorsed by HyperX.