samhenrigold/LidAngleSensor
LidAngleSensor
LidAngleSensor is a tool and sensor interface that retrieves the physical opening angle of a laptop screen by querying the internal Human Interface Device. It translates raw hardware sensor reports into a numerical representation of the lid's position.
The project functions as a lid-triggered audio player and a screen region capture tool. It can monitor hardware sensor state changes to play specific sound effects when a laptop lid opens or closes and isolate a defined coordinate area of the display buffer to copy a specific screen region to the clipboard.
The system handles hardware event automation and HID sensor integration through threshold-based event triggering and coordinate-based buffer cropping.
Features
- Laptop Lid Sensors - Determines the current opening angle of the laptop screen by accessing the internal hardware sensor.
- Raw-to-Angle Conversions - Converts raw hardware sensor output into a numerical representation of the lid opening angle.
- HID Device Communication - Queries Human Interface Device reports to read raw lid position sensor data.
- Sensor Integrations - Interfaces with HID reports to retrieve raw sensor data and translate it into software values.
- Sensor Polling - Retrieves the current state of the lid angle sensor via on-demand polling.
- Hardware-to-Software Mappings - Translates raw hardware sensor reports into numerical values representing the laptop lid's physical position.
- Lid Event Management - Retrieves the angle of the MacBook lid via the internal human interface device sensor.
- Audio Triggers - Provides a system that triggers specific sound effects automatically when the laptop lid is opened or closed.
- Lid State Monitoring - Reads the physical opening angle of a laptop screen using internal hardware sensors to trigger software actions.
- Hardware Event Automations - Executes tasks and plays sounds automatically based on the physical state of the laptop lid.
- Audio Triggers - Triggers specific audio playback in response to hardware sensor state changes.
- On-Demand Audio Triggers - Triggers specific sound effects whenever the laptop lid is opened or closed.
- State-Change Audio Feedback - Connects physical lid position changes to the playback of corresponding sound effects.
- Region Capture - Implements the ability to isolate and copy a specific coordinate-defined rectangular area of the display buffer.
- Sensor-Driven Event Triggers - Fires audio callbacks when monitored sensor values cross predefined numerical boundaries.
