ts1/BLEUnlock
BLEUnlock
BLEUnlock is a macOS automation tool and proximity-based system controller that monitors the range of trusted Bluetooth Low Energy devices to automate screen security and hardware-based unlocking. It functions as a background utility that identifies and filters nearby devices by their unique identifiers and signal strength to trigger system actions.
The system automatically manages screen lock states, waking the display and unlocking the computer when a paired device enters a defined signal range, or locking the screen and starting the screensaver when the device moves out of range.
Beyond security, the tool provides proximity-based system management, including the ability to pause or resume media playback and execute custom user-defined shell scripts in response to lock and unlock events.
Features
- Proximity Detection - Monitors signal strength from specific BLE hardware addresses to trigger system actions based on physical distance.
- Proximity-Based System Controllers - Provides a system controller that manages display sleep and media playback based on the proximity of trusted wireless devices.
- macOS Automation Tools - Serves as a background utility for triggering macOS system actions and custom scripts based on hardware proximity.
- Bluetooth Device Automations - Triggers custom shell scripts and system actions based on the presence or signal strength of nearby BLE devices.
- Bluetooth Device Scanners - Identifies nearby low energy devices by name or unique identifier and filters them by signal strength.
- BLE Device Pairing - Scans for nearby Bluetooth Low Energy signals and links specific devices to trigger lock actions.
- Asynchronous BLE Scanning - Implements asynchronous polling for BLE advertisements to prevent blocking the main application thread.
- Proximity Locks - Automatically locks or unlocks a computer based on the signal strength of paired BLE devices.
- Proximity-Based Lock Toggling - Changes the system lock state automatically based on the presence of paired Bluetooth Low Energy devices.
- Proximity-Based System Automation - Toggles display sleep and media playback based on the presence of a nearby Bluetooth device.
- Session Lock Controls - Triggers system-level screen lock and unlock actions based on Bluetooth device presence.
- Background Daemons - Operates as a persistent background system process to ensure continuous proximity monitoring.
- System State Manipulators - Interfaces with macOS APIs to programmatically toggle screen lock and wake display functions.
- Multi-Factor Device Unlocking - Provides a hands-free way to unlock the computer by using a paired BLE device as a security key.
- Proximity-Based Locking - Automatically locks or unlocks the computer when a trusted BLE device moves in or out of range.
- Session Lock Management - Toggles the system lock state based on the presence or absence of specific Bluetooth Low Energy devices.
- Proximity-Based Locking - Automatically locks the computer when a recognized Bluetooth Low Energy device moves out of range.
- RSSI Threshold Filtering - Evaluates raw Bluetooth signal levels against user-defined limits to determine device range.
- Conditional Display Automation - Automatically wakes the screen from sleep or starts the screensaver based on BLE device proximity.
- Event-Driven Scripting - Automatically executes user-defined shell scripts triggered by system lock and unlock events.
- Automated Playback Pausing - Automatically pauses or resumes music and video playback based on system lock state changes.
- Wake State Control - Wakes the screen from sleep via proximity sensors (BLE) as a trusted device approaches.
- Automation Script Execution - Runs custom user-defined scripts automatically whenever the system locks or unlocks.
- Proximity Signals - Uses Bluetooth signal strength thresholds as proximity signals to trigger screen locking or screensavers.
- Event-Triggered Scripts - Executes specific shell scripts in response to system lock events, providing trigger-specific arguments.
- Automatic Pause and Resume - Automatically manages media playback states in response to BLE-triggered system lock/unlock events.
