How pqrs-org/karabiner-elements works
Karabiner-Elements is a macOS key-remapping application. Its principal workflow is configuring device- or profile-specific modifications, then processing input events through manipulators and sending resulting events to virtual HID devices. Supporting branches cover device capture, settings and service coordination, and event inspection. The README establishes the product purpose; source-index references and excerpts support the cited internal links. Several runtime connections are not shown in the sampled sources, so those links are omitted or marked unverified.
Main entry points: manipulator_manager.hpp Manipulator manager · core_service_daemon_client.hpp Core service client · console_user_server/components_manager.hpp Console user server · daemon/components_manager.hpp Daemon components
Components 21
Configuration
- Profiles and rules
src/share/core_configuration/details/profile.hpp - Configuration model
src/share/core_configuration/core_configuration.hpp - Configuration monitor
src/share/monitor/configuration_monitor.hpp - Modification assets
src/apps/SettingsWindow/src/cpp/settings_complex_modifications_assets_manager.hpp
Input processing
- Device capture
src/apps/CoreService/include/core_service/daemon/device_grabber.hpp - Event queue
src/share/event_queue/queue.hpp - Manipulator manager
src/share/manipulator/manipulator_manager.hpp - Manipulator factory
src/share/manipulator/manipulator_factory.hpp - Modifier state
src/share/modifier_flag_manager.hpp - Virtual HID output
src/share/virtual_hid_device_utility.hpp
Background services
- Core service
src/apps/CoreService/src/main.cpp - Daemon components
src/apps/CoreService/include/core_service/daemon/components_manager.hpp - Console user server
src/apps/ConsoleUserServer/include/console_user_server/components_manager.hpp - Command receiver
src/apps/ConsoleUserServer/include/console_user_server/receiver.hpp
User applications
- Settings UI
src/apps/SettingsWindow/src/View/ContentView.swift - Event Viewer
src/apps/EventViewer/src/View/ContentView.swift - Command-line client
src/bin/cli/src/main.cpp
Shared runtime
- Core service client
src/share/core_service_daemon_client.hpp - XPC transport
src/share/xpc_client.hpp
Other components
- Mac user
- macOS input
Connections 20
- Mac user → Settings UI: configures
README.md - Settings UI → Profiles and rules: edits
- Profiles and rules → Configuration model: defines
- Configuration monitor → Configuration model: loads
src/share/monitor/configuration_monitor.hpp - Daemon components → Configuration monitor: observes
src/apps/CoreService/include/core_service/daemon/components_manager.hpp - Settings UI → Modification assets: manages
- macOS input → Device capture: provides input
- Device capture → Event queue: queues events
- Event queue → Manipulator manager: supplies events
src/share/manipulator/manipulator_manager.hpp - Manipulator manager → Manipulator factory: uses factory
src/share/manipulator/manipulator_manager.hpp - Manipulator manager → Modifier state: updates state
- Manipulator manager → Virtual HID output: posts events
- Core service → Daemon components: starts
- Daemon components → Device capture: manages
- Console user server → Configuration monitor: observes
src/apps/ConsoleUserServer/include/console_user_server/components_manager.hpp - Console user server → Command receiver: creates
src/apps/ConsoleUserServer/include/console_user_server/components_manager.hpp - Console user server → Core service client: notifies
src/apps/ConsoleUserServer/include/console_user_server/components_manager.hpp - Core service client → XPC transport: transports requests
src/share/core_service_daemon_client.hpp - Event Viewer → Core service client: queries service
- Command-line client → Core service client: sends commands
src/bin/cli/src/main.cpp