Skip to main content

🥐 B.R.I.O.S.

Bluetooth Reactive Intelligent Operator for Croissant Safety

A proximity monitoring system for macOS that automatically locks your Mac when your iPhone, Apple Watch, or any Bluetooth device moves out of range.

PythonBluetoothmacOS
🔍

BLE Device Discovery

Scan and identify nearby Bluetooth Low Energy devices with real-time signal strength and estimated distance.

🔒

Automatic Locking

Instantly locks your macOS screen when your trusted device moves beyond a configurable distance threshold.

🚀

Background Service

Run as a persistent daemon with full service lifecycle management — start, stop, restart, and status.

⚙️

Highly Configurable

Fine-tune distance thresholds, TX power calibration, path loss exponent, and signal smoothing for your environment.

🛡️

Smart Recovery

Lock loop protection, watchdog monitoring, and automatic scanner reconnection with exponential backoff.

🔐

Privacy First

Runs 100% locally. No internet, no telemetry, no data collection. Fully open source and auditable.

Quick Start

# Install via Homebrew
brew tap Piero24/brios https://github.com/Piero24/B.R.I.O.S.
brew install brios

# Discover nearby devices
brios --scanner 15 -m

# Configure and start monitoring
brios --start