pqrs-org/Karabiner-archivedArchived
Karabiner Archived
This project is a macOS keyboard remapping utility that intercepts and transforms hardware input events to customize key mappings, mouse behavior, and system automation. It utilizes a kernel-level input interceptor to modify or block raw hardware signals before they reach the operating system, paired with a state-aware rule engine that processes signals through conditional logic based on the active application or hardware.
The system includes a human interface device emulator to inject synthesized keyboard and mouse events into macOS and a keyboard macro system for executing shell commands, launching applications, or triggering system functions in response to input events.
The tool provides a comprehensive framework for device mapping, profile management, and rule definition. This includes capabilities for device-based input filtering, conditional input modifications, and the integration of predefined community rule sets. Diagnostic utilities are also available for real-time input event monitoring to verify configuration changes.
Features
- Keyboard Customizers - Provides a system-level utility for remapping keys and defining complex input sequences on macOS.
- Kernel-Level Input Remapping - Intercepts raw hardware input signals at the kernel driver level to modify or block data before it reaches the OS.
- Mode-Specific Keybindings - Implements custom input rules that automatically activate based on the currently focused application.
- Keyboard Macro Engines - Features a macro system that executes sequences of actions or shell commands based on input events.
- Input Remapping - Provides capabilities for substituting physical input keys and buttons across control configurations.
- HID Emulations - Emulates Human Interface Devices to inject synthesized keyboard and mouse events into macOS.
- Input Event Interception - Implements system-level hooks to capture and modify raw hardware input signals at the driver level.
- Input Event Interceptors - Implements system-level hooks to capture, modify, or block raw hardware input signals.
- Input Profile Managers - Implements a system for switching between different sets of keyboard and mouse configurations to support specialized workflows.
- Input Mapping Rule Definitions - Provides a system for creating personalized modification logic to override existing behavior or implement unique shortcuts.
- Input Remappers - Intercepts and redirects hardware input events to trigger custom system actions on macOS.
- Configuration Management Daemons - Implements a background daemon to manage communication and real-time rule updates between the kernel driver and user interface.
- Hardware Key Remapping - Modifies the default behavior of physical hardware keys at the system level via a configuration interface.
- Context-Aware State Engines - Uses a state-aware engine to drive context-dependent input behavior based on active applications.
- Configuration-Driven Rule Engines - Uses a configuration-driven engine to parse user-defined rules and transform incoming input signals into system outputs.
- Input Device Emulators - Creates software-based input devices to inject synthesized keyboard and mouse events into the system.
- Conditional Modification Rules - Activates custom input modifications dynamically based on the active application focus or specific system conditions.
- Input Device Filtering - Filters input streams based on hardware IDs to isolate settings or disable specific devices.
- Rule Set Integrations - Allows importing community-provided rule sets for specialized behaviors such as editor-style key bindings.
- Input Event Visualizers - Ships a diagnostic tool that displays real-time hardware input events to verify configuration rules.
- Kernel-User Space Interfacing - Ships a background daemon that manages the interface between kernel-level drivers and user-space configuration.
- Declarative Configuration Schemas - Provides a system for defining input mapping behavior and policies using structured configuration files.
- Processing Order Prioritization - Utilizes a prioritized transformation stack to evaluate incoming hardware events against ordered rules.
- System Automation - Provides automated workflows to execute shell commands and launch applications in response to input events.
- Productivity Tools - Listed in the “Productivity Tools” section of the Awesome Mac awesome list.
