# foobot-local: local Foobot service and reconstructed protocols

> foobot-local reconstructs Foobot communication so the air-quality monitor can send readings to a local service. It documents MQTT topics, a UDP AT configuration channel and Wi-Fi provisioning recovered from the official APK; the Python service decodes readings and computes a pollution index.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/kerosix/foobot-local>
- Primary source: <https://github.com/kerosix/foobot-local/blob/043bfb8dba794bc829ef6f650ce905bdfbb4ac7c/README.md>
- Catalog page: <https://awesomerea.org/resources/foobot-local-case/>
- Record JSON: <https://awesomerea.org/resources/foobot-local-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/foobot-local-case/index.md)

## Requirements & limits

- **Prerequisites:** A Foobot and an always-on Linux host on the same LAN, with Python 3 and dnsmasq or another configurable DNS service.
- **Limits:** The calibration constants were derived from one device; other units may need their own calibration.
- **Limits:** The device computes its ring colour from thresholds that the project has not captured.
- **License:** MIT license.

## Primary sources

1. <https://github.com/kerosix/foobot-local/blob/043bfb8dba794bc829ef6f650ce905bdfbb4ac7c/README.md>
2. <https://github.com/kerosix/foobot-local/blob/043bfb8dba794bc829ef6f650ce905bdfbb4ac7c/docs/PROTOCOL.md>
3. <https://github.com/kerosix/foobot-local/blob/043bfb8dba794bc829ef6f650ce905bdfbb4ac7c/docs/WIFI.md>

## More in Protocols

- [noirm1: reconstructing NOIR M1 mouse settings](https://awesomerea.org/resources/noirm1-mouse-protocol-case/index.md) · Case study
- [PetMarvel C1: reconstructing local litter-box control](https://awesomerea.org/resources/petmarvel-c1-local-case/index.md) · Case study
- [omen-lcd: reconstructing HP OMEN cooler LCD control](https://awesomerea.org/resources/omen-lcd-hp-cooler-case/index.md) · Case study
- [QCY Control for macOS: implementing MeloBuds Pro BLE controls](https://awesomerea.org/resources/qcy-control-macos-case/index.md) · Case study
- [BTHackers: reconstructing the AIREC recorder’s BLE protocol](https://awesomerea.org/resources/bthackers-airec-case/index.md) · Case study
- [MacBook ALS: mapping five HID color channels](https://awesomerea.org/resources/macbook-als-spectral-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.