# dannymcc/bluehood

Monitor your local neighbourhood's bluetooth activity

Repository: https://github.com/dannymcc/bluehood
Canonical: https://ross.abutalabs.com/products/bluehood
Language: Python
License: MIT
License Family: permissive
Topics: ble, bluetooth, flask, monitoring, privacy, python, raspberry-pi, security
Last push: 2026-08-12T12:49:50+00:00

## Health v2 (maintenance only)
Score: 77/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 87, longevity 16
- inputs: {"age_days": 228, "days_push": 21, "days_rel": 84, "gap_med": 0.0, "n_releases_24m": 13}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1059, forks 74 (observed 2026-08-28T04:03:25.594940+00:00)

## What it is
Bluehood is a self-hosted Bluetooth scanner that passively detects nearby BLE and Classic Bluetooth devices, identifies them by vendor and service UUIDs, and tracks their presence patterns over time. It provides a Flask-based web dashboard with heatmaps, device grouping, and push notifications, built as an educational tool to raise awareness of Bluetooth privacy risks.

## Use cases
- monitor bluetooth devices in my neighborhood
- track when specific BLE devices arrive or leave
- detect privacy risks from nearby bluetooth devices
- analyze presence patterns of bluetooth devices over time
- identify unknown devices by MAC vendor and service UUIDs
- get notified when a watched device is nearby
- run a bluetooth scanner on a raspberry pi

## When to choose
- you want a self-hosted, passive Bluetooth/BLE presence monitor with a web dashboard
- you're exploring Bluetooth privacy risks or demonstrating device tracking for education
- you run a Raspberry Pi or always-on Linux box near an area of interest

## When to avoid
- you need production-grade, stable software - it's explicitly alpha and may break
- you want active Bluetooth exploitation or pairing attacks - Bluehood only passively observes
- you need commercial-grade asset tracking or indoor positioning accuracy

## Facets
- artifact type: application
- maturity: experimental
- function: monitoring, security, analytics, web-framework
- domain: security, privacy, monitoring, iot, developer-tools
- platform: python, iot, self-hosted
- tags: bluetooth, ble, bluetooth-scanning, device-tracking, privacy-awareness, flask, raspberry-pi, passive-scanning, mac-vendor-lookup, presence-detection, linux, web-server

## Member repositories
- dannymcc/bluehood (main) score 77

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:25.594940+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:57:13.371008+00:00, confidence not recorded.
  - readme: https://github.com/dannymcc/bluehood (fetched 2026-08-28T04:03:25.594940+00:00, sha 20a8d6b99e60)
- Data as of 2026-08-30T08:39:29.467469+00:00.