High-performance input sequencing for professional automation.

AuraKey is a precision macro engine and low-level system tray daemon designed for high-performance input automation. By bridging a modern React/Tauri interface with a high-speed Rust backend, AuraKey provides a seamless bridge between software flexibility and hardware-level execution. Whether you are automating complex input chains across keyboard, mouse, and XInput devices or utilizing the integrated AuraHID Arduino passthrough for hardware-level simulation, AuraKey delivers near-zero latency and total invisibility in any environment.

• Multi-Input Triggers — Bind macros to keyboard shortcuts, mouse buttons, or Xbox/XInput controller buttons
• Macro Sequencing — Record or manually build multi-step macros with key presses, mouse actions, delays, and more
• Step Types — Key tap, key hold, mouse click, mouse move, scroll, delay, Run Program, and text type
• Execution Modes — Sequential, timeline (absolute timestamps), or continuous (repeating loop)
• Profile System — Organize macros into profiles with named groups, enable/disable individually
• Recording — Capture keyboard and mouse input in real-time with configurable countdown and duration
• Screen Detection — High-speed PixelMatch and native WinRT OCR for context-aware automation
• Auto Gesture Switching — Automatically transition between macro states based on on-screen events
• Arduino HID Passthrough — Route keystrokes through an Arduino for hardware-level input simulation
• Import / Export — Share macro profiles as .akg files
• Conflict Detection — Warns when multiple macros share the same trigger
• System Tray — Daemon runs silently with a tray icon; GUI connects via named pipe IPC

┌─────────────────┐       Named Pipe IPC       ┌──────────────────────┐
│   aurakey.exe   │  ◄──────────────────────►  │  aurakey.exe --service │
│   (Tauri GUI)   │                            │      (Daemon)          │
└─────────────────┘                            └──────────────────────┘
                                                ├─ Input hooks (keyboard, mouse, XInput)
                                                ├─ Screen detection (PixelMatch + WinRT OCR)
                                                ├─ Macro executor
                                                ├─ Config manager
                                                └─ Arduino bridge

• aurakey.exe — The unified AuraKey binary. By default, it launches the high-fidelity Tauri GUI.
• aurakey.exe --service — When launched with the --service flag, it runs as the standalone background daemon, managing hotkeys, the system tray, and macro execution. The GUI auto-launches this process if it isn't already active.

AuraKey features a powerful, dual-mode screen detection engine that allows your macros to react to the environment in real-time. This enables "Smart Workflows" that automatically switch gestures based on what is happening on your screen.

• PixelMatch Engine: An ultra-performance GDI-based detector that checks specific pixel coordinates for color matches in under 1ms. Perfect for detecting health bars, cooldown icons, or UI state changes.
• WinRT OCR: Native Windows Optical Character Recognition allows AuraKey to "read" text within defined screen regions. Use this to trigger gestures when specific words appear on screen or when a game state changes.
• Reactive Switching: Configure workflows to automatically switch to specific gestures when a match is detected, allowing for complex, context-aware macro behavior without manual intervention.
• Trigger Modes: Run scans periodically (e.g., every 500ms) or trigger a screen check only when a specific key is pressed to minimize system overhead.

AuraKey simplifies hardware-level automation with a built-in firmware management system for Arduino Leonardo and Pro Micro boards.

• One-Click Export: Save the pre-configured AuraHID.ino sketch directly from the Settings panel to your local machine.
• Seamless Setup: A detailed in-app guide walks you through flashing your board via the Arduino IDE for instant hardware-level input.
• Intelligent Fallback: AuraKey automatically detects hardware status and gracefully falls back to software simulation (SendInput) if the Arduino is disconnected.

The AuraHID firmware is engineered for absolute authenticity and stealth:

• Composite HID Descriptors: Utilizing the HID-Project library, the Arduino presents itself to Windows as a composite USB device. It simultaneously emulates a standard keyboard, a high-resolution mouse, and a consumer media controller.
• Genuine Hardware Passthrough: Because the device operates at the USB protocol level, inputs are indistinguishable from those of a physical peripheral. This bypasses software-level hooks and provides a direct, low-latency execution path.
• Multimodal Control: The firmware handles standard keystrokes, relative mouse offsets, and secondary media commands (Volume, Play/Pause) through separate top-level collections in the HID report, ensuring maximum compatibility across all software.

• Node.js 18+
• Rust 1.75+
• Windows 10/11

# Install frontend dependencies
npm install

# Launch in dev mode
# This will compile the unified Rust binary and start the React frontend
npm run tauri dev

npm run tauri build

The production build generates a single unified aurakey.exe binary. The GUI and background service are both handled by this executable, ensuring a simplified deployment and update process.

Config is stored in %APPDATA%/AuraKey/config.toml. Open it from the app via Settings → Config Directory → Open.

MIT