What's Changed
macOS Support: UUID Address Handling (#19)
macOS CoreBluetooth provides UUID-format addresses instead of real MAC addresses for privacy. Bluehood now detects and handles these gracefully:
- Skips MAC randomization checks for UUID addresses (avoids false positives)
- Skips vendor OUI lookups for UUIDs (they have no OUI)
- Truncates long UUIDs in the web UI table with full address in tooltips
- Renames "MAC Address" labels to "Address" throughout the UI
- Handles UUID obfuscation in screenshot mode
BLE Adapter Documentation (#20)
- Documented that Bluetooth 4.0+ with BLE Central role support is required
- Added troubleshooting guidance for users with older adapters
- Included the specific error message users will see with incompatible hardware
Docker
docker pull ghcr.io/dannymcc/bluehood:v0.3.5
Contributors
- @dazzag24 - Reported macOS address format issue (#19)
- @unqualifiedkoala - Documented BLE adapter requirements (#20)