RAVINDRAN S.SDE
Keynix icon
Linux SystemsActive development

Keynix Keyboard Platform

System-level evdev remapping, shortcut conflict detection, and typing practice.

Hardware-level Linux input interception using evdev EVIOCGRAB exclusive grabbing and uinput virtual device synthesis, with visual layout editing and shortcut conflict auditing.

Release Versionv0.1.0
ArchitectureUniversal / Multi
PlatformsLinux
LicenseOpen Source (MIT/GPL)
keynix · console
VERIFIED
$ quick_launch
git clone https://github.com/ravindran-dev/keynix.git
Primary StackLinux evdev (EVIOCGRAB), uinput
LanguagesRust, TypeScript, React
Release StageActive development
IntegritySHA-256 Audited
Manifest Revision:0.1.0 (Workspace crate)

Input Virtualization Pipeline

Kernel Input Interception & Synthesis

Sub-0.1ms latency event grabbing and uinput virtual device emission.

01 · PHYSICAL HARDWARE

/dev/input/event*

Raw physical USB / Bluetooth keystrokes from keyboard

02 · GRAB & FILTER

evdev EVIOCGRAB

Exclusive hardware lock; fail-safe killswitch protection

03 · MAPPING ENGINE

Worker Thread

Applies user presets, detects shortcut conflicts across DEs

04 · SYNTHESIS

/dev/uinput

Emulates virtual HID keyboard into Wayland & X11 sessions

Core Capabilities

Engineered for Reliability

01

Hardware-Aware Interception

Intercepts physical keyboards via evdev exclusive grabbing (EVIOCGRAB) and synthesizes virtual hardware through /dev/uinput.

02

Zero Lag & Stuck-Key Immunity

Dedicated high-priority worker thread with non-blocking polling and automatic release guarantees.

03

Fail-Safe Killswitch

Pressing Ctrl+Alt+Shift+Esc at any time immediately releases physical devices and restores native passthrough.

04

Shortcut Conflict Discovery

Audits active hotkeys across Hyprland, GNOME GSettings, KDE Global Shortcuts, and XKB layout rules.

Developer Setup

Installation & SDK Quickstart

Verified tag v0.1.0
Build and Install from Source
git clone https://github.com/ravindran-dev/keynix.git
cd keynix
bash install.sh

Requirement Note: Requires Rust stable, libevdev development headers, and input group permissions.

Low-Level Systems

Kernel-level input virtualization without compromises

Keynix grants complete mastery over input devices without requiring custom firmware or proprietary manufacturer software.

01

evdev Exclusive Grabbing

Uses EVIOCGRAB to prevent host operating system and desktop environments from seeing raw physical key events.

02

Virtual uinput Synthesis

Emulates a clean USB HID device capable of emitting arbitrary keycodes, modifiers, and multi-key macros.

03

Visual Layout Customizer

Interactive SVG editor supporting ANSI Full 104, TKL, 65%, and 60% keyboards with instant conflict resolution.

Under the Hood

Technical Specifications

Architecture Blueprint

Keynix sits between the physical hardware and the display server: Physical Keyboard (/dev/input/event*) -> evdev Interception -> Keynix Mapping Engine -> uinput Virtual Device -> Linux OS. A local SQLite database stores user presets and typing analytics.

Technology Stack
Linux evdev (EVIOCGRAB)uinputTokioSQLiteTailwind CSS

Supported Platforms

Linux (Wayland & X11: Arch, Fedora, Ubuntu, Debian)

Implementation Languages

Rust
TypeScript
React

System & Hardware Requirements

Operating System: Linux kernel 5.4+ with evdev and uinput support
Permissions: User in 'input' group and write access to /dev/uinput
Display Server: Wayland (Hyprland, Sway, GNOME, KDE) or X11
Build: Rust 1.75+ and Node.js 18+ (for frontend GUI)

Developer Documentation

Manuals, Specs & Source

Frequently Asked

Questions & Details

Does Keynix cause input lag?+

No. Keynix runs a dedicated non-blocking polling worker thread in Rust that processes events in under 0.1ms.

What happens if Keynix crashes?+

Keynix registers signal handlers that instantly drop the EVIOCGRAB lock, restoring normal keyboard behavior. The hardware killswitch (Ctrl+Alt+Shift+Esc) also ungrabs immediately.

Does it work on Wayland?+

Yes! Because Keynix operates at the kernel evdev/uinput layer, it is completely independent of Wayland or X11.

Official Software Releases

More Products & Developer Toolchains

Explore All Products
Developer Tools

LocalMind Agent SDK & Runtime

Active development

Loopback-only local AI agent runtime, terminal assistant, and Python streaming SDK.

A private, local-first LLM orchestration system that connects your terminal, local workspace index, and host telemetry through a lightweight Rust launcher and typed Python SDK without sending data to third-party clouds.

tag v0.1.0LinuxPython 3.12+Rust
Desktop & Mobile

Hertix Music Player

Active development

Your music library, kept close and under your control.

A local-first media library and player spanning a native Android app and a Windows desktop app.

tag v1.0.23Android 8+KotlinTypeScript
Developer Tools

Quantum IDE

Active development

A focused, offline-first coding workspace for Windows.

A native desktop IDE built around Monaco, a local Express service and an Electron shell.

WindowsJavaScriptPython