pwr-Solaar/Solaar
Solaar
Solaar is a device management tool and configuration suite for Logitech wireless peripherals on Linux. It serves as an input peripheral monitor that tracks battery levels and connection link quality via a system tray application, while providing a receiver manager for pairing and unpairing wireless devices with proprietary USB receivers.
The project features an input device automation engine that maps hardware events and mouse gestures to simulated keyboard inputs or system commands. This allows for the creation of custom rules that trigger actions based on device notifications or specific window focus.
The toolkit covers a wide range of hardware customizations, including DPI and polling rate adjustments, LED lighting control, and scroll behavior modification. It also supports advanced keyboard tuning for magnetic switches, haptic feedback triggering, and the management of onboard device profiles.
A command-line interface is available for executing pairing, configuration, and management tasks in headless or automated environments.
Features
- Peripheral Device Managers - Implements a comprehensive system for discovering and interacting with wireless peripherals via USB, Bluetooth, or proprietary receivers.
- Input Customization - Provides tools to adjust hardware settings including DPI, polling rates, and LED lighting.
- HID Device Communication - Interacts with peripherals by reading and writing raw reports directly to HID character devices.
- Input Behavior Configurators - Offers sliders and toggles to adjust hardware sensitivity, scrolling direction, and backlighting.
- Peripheral Lighting Controllers - Provides control over individual and group LED lighting settings on supported hardware.
- Pointer Precision Settings - Allows precise adjustment of mouse DPI, lift-off distance, and sensitivity axes.
- Polling Rate Configurations - Allows users to set the report rate for movement data using sub-millisecond intervals for higher precision.
- USB Receiver Management - Provides a manager for pairing peripherals with proprietary USB receivers and handling onboard profiles.
- Wireless Peripheral Pairing - Provides utilities to pair and unpair wireless peripherals with compatible USB receivers.
- Hardware Profile Managers - Manages and toggles onboard hardware profiles to persist settings like DPI and polling rates.
- Daemon-Client Structures - Implements a daemon-client architecture to separate low-level hardware monitoring from the user interface.
- Device Management Tools - Provides a dedicated utility for configuring hardware settings and monitoring battery levels for Logitech wireless peripherals.
- Peripheral Battery Monitors - Features a system tray application that tracks battery status and connection quality for wireless peripherals.
- Status Monitors - Provides a real-time display of battery levels and connection link status within the system tray.
- Device-Specific Input Rules - Implements a rule-based system that triggers system commands and shortcuts based on hardware device events.
- Input Automation Engines - Ships a rule-based engine that maps hardware events and mouse gestures to simulated keyboard inputs.
- Scroll Behavior Control - Enables modification of scroll wheel resolution and direction to customize navigation.
- Peripheral State Restoration - Persists hardware configuration options and restores them automatically when devices reconnect.
- Automation Rules - Provides a mechanism to execute specific automated rules in response to messages from connected hardware.
- Event-Driven Automation Engines - Ships an event-driven engine that triggers system actions based on hardware notifications.
- Hardware Configuration Automations - A feature in the product that changes or toggles hardware configuration settings as part of an automated rule.
- HID Event Automation - Processes device events via a rule-based system to trigger specific actions or hardware changes.
- Input Remapping - Allows reassigning physical hardware buttons to different system functions or virtual keys.
- Actuation Tuning - Provides advanced tuning for magnetic switch actuation points and rapid-trigger sensitivity.
- Virtual Input Emulators - Sends virtual keyboard and mouse events to the operating system to simulate physical interactions.
- Hardware Configuration Persistence - Tracks and restores device-specific configuration settings and profiles when peripherals reconnect.
- CLI System Management - Provides a command-line interface for pairing, configuration, and device management in headless environments.
- Input Event Emulations - Performs virtual mouse clicks, depressions, releases, and scrolling to automate interactions.
- Haptic Feedback Controllers - Triggers haptic waveforms and tactile responses on compatible devices via CLI or rules.
- Key Sequence Simulators - Sends synthetic key symbols and sequences to the OS to emulate physical keyboard presses.
- Mouse Gesture Definition - Provides a tool to assign buttons to initiate movement-based gestures that trigger custom rules.
- Mouse Gesture Mapping - Allows mapping specific button combinations and mouse movements to execute automated tasks.
