https://github.com/guycole/mellow-heeler-v2

Collect and store WiFi AP beacons
https://github.com/guycole/mellow-heeler-v2

Last synced: about 1 month ago
JSON representation

Collect and store WiFi AP beacons

• Host: GitHub
• URL: https://github.com/guycole/mellow-heeler-v2
• Owner: guycole
• License: gpl-3.0
• Created: 2026-05-09T06:48:05.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2026-05-25T20:52:35.000Z (about 2 months ago)
• Last Synced: 2026-05-25T22:15:35.956Z (about 2 months ago)
• Language: Python
• Size: 86.9 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# mellow-heeler-v2

[Wireless Access Point](https://en.wikipedia.org/wiki/Wireless_access_point) collection application.

## Introduction

A Mellow Heeler client observes [wireless beacons](https://en.wikipedia.org/wiki/Beacon_frame) and shares the observation w/a backend for storage and reporting.

Mellow Heeler collectors use [Raspberry Pi 3](https://www.raspberrypi.org/) augmented w/a USB WiFi adapter such as [TP Link AC1300](https://www.tp-link.com/us/home-networking/usb-adapter/archer-t3u-plus/).

## Notes

1. Autonomous collection of wireless beacons for 2.4 and 5 GHz using the iwlist(8) utility.

2. Each observation produces two output files: a copy of the current iwlist(8) output and a json summary of key features extracted from the iwlist(8) output along with observation metadata.

3. iwlist(8) must run from root crontab(1)

4. The collection pass runs from wombat crontab(1)

5. Output file directory is defined within config.yaml

## Sample JSON output

```

{

    "geoLoc": {

        "altitude": MSL in meters

        "latitude": +north decimal degress

        "longitude": +east decimal degrees

        "site": site name

    },

    "epochSeconds": collection time in seconds since epoch

    "fileName": file name

    "iso8601": epochSeconds as a ISO861 string

    "mode": collection application (currently only "iwlist")

    "platform": collection host name

    "project": source project (currently "heeler-v2")

    "version": schema version (currently 1)

    "observations": [

        {

            "bssid": "E2:BB:9E:D0:B0:30",

            "frequency_mhz": 2437,

            "signal_dbm": -75,

            "ssid": "DIRECT-9ED03030",

            "capabilities": "wpa2-psk",

            "cipher_type": "CCMP"

        }

    ]

}

```