macOS BLE scanner. Discovers nearby Bluetooth Low Energy devices and reports name, RSSI, connectable status, advertised services, and manufacturer data.
make build
CLI binary requires Bluetooth permission. Two options:
Option A — app bundle (recommended for first run, triggers macOS permission dialog):
make app
open BLEScan.app
Option B — direct (works after permission is granted to the parent terminal):
.build/release/ble-scan
-d, --duration <seconds> Scan duration (default: 8)
-o, --output <path> Write results to file
-j, --json Output as JSON
-h, --help Show this help
# 15-second scan, JSON output
ble-scan -d 15 -j
# Save results to file
ble-scan -o scan.txt
# Quick 3-second sweep
ble-scan -d 3
- macOS 13+
- Swift 5.9+
- Bluetooth permission (granted on first .app launch)