Skip to content

frnkptrln/ble-density-gauge

Repository files navigation

BLE Density Gauge

Status: archived technical prototype. The gauge UI is implemented, but an external Flipper Zero application (.fap) cannot access the low-level BLE observation APIs required to supply real measurements. The repository is preserved as an interface and feasibility study; it is not a working BLE density scanner.

BLE Density Gauge explored a privacy-preserving ambient signal: showing nearby Bluetooth Low Energy activity as an aggregate System Mass Index, without listing devices, storing addresses, or tracking individuals.

What exists

  • a monochrome tachometer-style interface for the Flipper Zero;
  • rolling density state and presentation logic;
  • an early scanner abstraction;
  • source and manifest files that can still be built as a UI prototype.

Why it is archived

The official Flipper Zero firmware does not expose the required low-level BLE observation commands to external SD-card applications. As a result, the current .fap cannot receive genuine advertisement events and the gauge remains at zero. Additional application-level code cannot solve that boundary.

The earlier README described the intended scanner behavior in more detail than the implementation could actually provide. This status replaces that claim with the narrower, verified one: the repository demonstrates the interaction concept and UI, not live radio measurement.

What a real revival would require

A functional implementation would need one of the following:

  1. a supported BLE observation API for external applications; or
  2. deliberate integration into a firmware build with access to the internal BLE stack, accompanied by hardware validation and a clear privacy review.

Until one of those conditions changes, the project remains read-only in spirit and should not be presented as an installable scanner.

Build the UI prototype

python3 -m pip install --upgrade ufbt
ufbt

The resulting .fap, if the current SDK accepts the sources, demonstrates the interface only. It does not perform BLE scanning.

Privacy boundary

The intended design uses aggregate advertisement activity only. It must not store MAC addresses, expose device lists, infer identities, or claim an exact device count.

License

MIT License — see LICENSE.

About

A passive BLE scanner for the Flipper Zero that turns invisible Bluetooth advertisements into a real-time 'Index' of your surroundings.

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages