# andrewjfreyer/monitor

Distributed advertisement-based BTLE presence detection reported via mqtt

Repository: https://github.com/andrewjfreyer/monitor
Canonical: https://ross.abutalabs.com/products/monitor
Language: Shell
License Family: other
Topics: beacon, cell-phone, mqtt-message, advertisement, btle, presence-detection, bluetooth-devices
Last push: 2024-07-31T17:50:15+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3032, "days_push": 763, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2111, forks 198 (observed 2026-08-28T04:06:14.273368+00:00)

## What it is
A shell-based application that performs passive Bluetooth Low Energy (BTLE) presence detection of beacons, cell phones, and other Bluetooth devices. It reports detected devices via MQTT, making it useful for distributed home automation setups across multiple devices.

## Use cases
- detect when family members arrive home using their cell phone bluetooth signals
- track bluetooth beacons for room-level presence detection in home automation
- set up distributed presence detection across multiple raspberry pis reporting to mqtt
- trigger home automation scenes based on which bluetooth devices are nearby
- passively monitor bluetooth devices without pairing or connecting
- integrate bluetooth presence detection with home assistant via mqtt

## When to choose
- you need passive, unobtrusive bluetooth presence detection without pairing
- you want to run detection on multiple low-cost devices like raspberry pi zero w distributed around a property
- your home automation stack already uses mqtt as a message bus
- you want a lightweight shell-based solution with minimal dependencies

## When to avoid
- you need active bluetooth connection-based tracking rather than passive advertisement listening
- you require a maintained project with an explicit license and active development
- you need presence detection on non-linux platforms like windows or macos
- you want a plug-and-play solution without manual raspberry pi setup

## Facets
- artifact type: application
- maturity: maintenance
- function: monitoring, iot, message-queue
- domain: iot, self-hosted
- platform: iot, cli
- tags: bluetooth, btle, presence-detection, mqtt, home-automation, beacon, shell-script, automation, linux

## Member repositories
- andrewjfreyer/monitor (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:14.273368+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-30T02:53:43.062070+00:00, confidence not recorded.
  - readme: https://github.com/andrewjfreyer/monitor (fetched 2026-08-28T04:06:14.273368+00:00, sha 1c5f0e38c59b)
- Data as of 2026-08-30T08:39:29.467469+00:00.