Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/simeononsecurity/track-helium-mobile-wifi

A collection of scripts and tools that tracks the availability of helium mobile wifi networks in the wild from the Wigle Dataset and Helium API. Updates every 24 hours.
https://github.com/simeononsecurity/track-helium-mobile-wifi
automation bigdata carrieroffload data data-analysis dataset dataset-generation helium openroaming passpoint python
Last synced: 6 days ago
JSON representation
A collection of scripts and tools that tracks the availability of helium mobile wifi networks in the wild from the Wigle Dataset and Helium API. Updates every 24 hours.
Host: GitHub
URL: https://github.com/simeononsecurity/track-helium-mobile-wifi
Owner: simeononsecurity
License: mit
Created: 2024-08-12T02:01:19.000Z (3 months ago)
Default Branch: main
Last Pushed: 2024-10-25T00:16:20.000Z (21 days ago)
Last Synced: 2024-10-25T05:43:22.668Z (21 days ago)
Topics: automation, bigdata, carrieroffload, data, data-analysis, dataset, dataset-generation, helium, openroaming, passpoint, python
Language: HTML
Homepage: http://heliummap.simeononsecurity.com/
Size: 166 MB
Stars: 7
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project

README

        # Track Helium Mobile WiFi

[![Sponsor](https://img.shields.io/badge/Sponsor-Click%20Here-ff69b4)](https://github.com/sponsors/simeononsecurity) [![Interactive Map](https://img.shields.io/badge/Interactive%20Map-View%20Here-blue)](https://heliummap.simeononsecurity.com)

A collection of scripts and tools that tracks the availability of Helium Mobile WiFi networks in the wild.

Pulls from the Wigle.net dataset and from the Helium Blockchain Exporter/API

> **Note**: Information here may not be entirely accurate or complete, but it's the best semi-public dataset available for tracking this kind of information that is verified by 3rd parties. 

The stats are dynamic, we only pull year to date stats. But ultimately we'll update it to do devices mapped in the last 365 days.

> **Note:**: All of the categorizations and identifiers were discovered from public documentation and research that is repeatable with google searches. 

### Helium Mobile WiFi Table Mapped

![WigleNet Sourced Helium Mobile WiFi Table Map](https://github.com/simeononsecurity/track-helium-mobile-wifi/blob/main/output/global_wifi_map.png)

## Helium Provided and Sourced Stats

### Device Status

| Status | Count |

| --- | --- |

| Active | 15891 |

| Inactive | 12608 |

### Residential vs Business

| Category | Percentage |

| --- | --- |

| Residential | 72.03% |

| Business | 27.97% |

### Top 10 Class-Type Combinations

| Class | Type | Count |

| --- | --- | --- |

| place | house | 6077 |

| building | yes | 2241 |

| highway | residential | 1418 |

| amenity | parking | 755 |

| building | house | 658 |

| amenity | school | 306 |

| highway | secondary | 271 |

| highway | tertiary | 258 |

| highway | motorway | 193 |

| building | apartments | 187 |

![Daily Data Transfer](https://github.com/simeononsecurity/track-helium-mobile-wifi/blob/main/output/daily_data_transfer.png)

#### Data Transfer Growth

| Date | Daily Growth (%) | Weekly Growth (%) |

| --- | --- | --- |

| 2024-06-26T00:00:00 | 69.77% | 516.45% |

| 2024-06-27T00:00:00 | -12.10% | 516.45% |

| 2024-06-28T00:00:00 | 33.16% | 516.45% |

| 2024-06-29T00:00:00 | -13.07% | 516.45% |

| 2024-06-30T00:00:00 | -14.23% | 516.45% |

| 2024-07-01T00:00:00 | -9.69% | 516.45% |

| 2024-07-02T00:00:00 | -8.09% | 516.45% |

| 2024-07-03T00:00:00 | 28.24% | 155.97% |

| 2024-07-04T00:00:00 | -5.39% | 155.97% |

| 2024-07-05T00:00:00 | 17.55% | 155.97% |

| 2024-07-06T00:00:00 | 0.37% | 155.97% |

| 2024-07-07T00:00:00 | -16.95% | 155.97% |

| 2024-07-08T00:00:00 | -26.31% | 155.97% |

| 2024-07-09T00:00:00 | 4.08% | 155.97% |

| 2024-07-10T00:00:00 | 2.48% | 56.98% |

| 2024-07-11T00:00:00 | 31.56% | 56.98% |

| 2024-07-12T00:00:00 | -15.40% | 56.98% |

| 2024-07-13T00:00:00 | 3.31% | 56.98% |

| 2024-07-14T00:00:00 | -19.37% | 56.98% |

| 2024-07-15T00:00:00 | 2.53% | 56.98% |

| 2024-07-16T00:00:00 | 2.13% | 56.98% |

| 2024-07-17T00:00:00 | 14.08% | 30.24% |

| 2024-07-18T00:00:00 | 10.85% | 30.24% |

| 2024-07-19T00:00:00 | 9.19% | 30.24% |

| 2024-07-20T00:00:00 | 9.40% | 30.24% |

| 2024-07-21T00:00:00 | -9.84% | 30.24% |

| 2024-07-22T00:00:00 | -26.73% | 30.24% |

| 2024-07-23T00:00:00 | -26.99% | 30.24% |

| 2024-07-24T00:00:00 | 36.96% | 25.45% |

| 2024-07-25T00:00:00 | 1.04% | 25.45% |

| 2024-07-26T00:00:00 | 18.48% | 25.45% |

| 2024-07-27T00:00:00 | 1.04% | 25.45% |

| 2024-07-28T00:00:00 | 2.46% | 25.45% |

| 2024-07-29T00:00:00 | 8.49% | 25.45% |

| 2024-07-30T00:00:00 | 41.20% | 25.45% |

| 2024-07-31T00:00:00 | -16.14% | 21.48% |

| 2024-08-01T00:00:00 | -3.36% | 21.48% |

| 2024-08-02T00:00:00 | 12.13% | 21.48% |

| 2024-08-03T00:00:00 | 8.32% | 21.48% |

| 2024-08-04T00:00:00 | 6.21% | 21.48% |

| 2024-08-05T00:00:00 | 34.15% | 21.48% |

| 2024-08-06T00:00:00 | 5.98% | 21.48% |

| 2024-08-07T00:00:00 | 10.29% | 28.20% |

| 2024-08-08T00:00:00 | -2.10% | 28.20% |

| 2024-08-09T00:00:00 | 16.05% | 28.20% |

| 2024-08-10T00:00:00 | 17.38% | 28.20% |

| 2024-08-11T00:00:00 | 2.62% | 28.20% |

| 2024-08-12T00:00:00 | -19.15% | 28.20% |

| 2024-08-13T00:00:00 | -6.38% | 28.20% |

| 2024-08-14T00:00:00 | 3.80% | 38.39% |

| 2024-08-15T00:00:00 | 22.36% | 38.39% |

| 2024-08-16T00:00:00 | 21.72% | 38.39% |

| 2024-08-17T00:00:00 | 19.93% | 38.39% |

| 2024-08-18T00:00:00 | -7.31% | 38.39% |

| 2024-08-19T00:00:00 | -27.72% | 38.39% |

| 2024-08-20T00:00:00 | 4.28% | 38.39% |

| 2024-08-21T00:00:00 | 57.99% | 35.97% |

| 2024-08-22T00:00:00 | 20.38% | 35.97% |

| 2024-08-23T00:00:00 | 20.16% | 35.97% |

| 2024-08-24T00:00:00 | 6.33% | 35.97% |

| 2024-08-25T00:00:00 | 2.13% | 35.97% |

| 2024-08-26T00:00:00 | -20.04% | 35.97% |

| 2024-08-27T00:00:00 | 27.50% | 35.97% |

| 2024-08-28T00:00:00 | 21.67% | 52.25% |

| 2024-08-29T00:00:00 | 15.93% | 52.25% |

| 2024-08-30T00:00:00 | 9.49% | 52.25% |

| 2024-08-31T00:00:00 | 24.70% | 52.25% |

| 2024-09-01T00:00:00 | -2.93% | 52.25% |

| 2024-09-02T00:00:00 | -22.01% | 52.25% |

| 2024-09-03T00:00:00 | -20.73% | 52.25% |

| 2024-09-04T00:00:00 | 16.08% | 60.47% |

| 2024-09-05T00:00:00 | 48.90% | 60.47% |

| 2024-09-06T00:00:00 | 24.68% | 60.47% |

| 2024-09-07T00:00:00 | 19.59% | 60.47% |

| 2024-09-08T00:00:00 | -14.66% | 60.47% |

| 2024-09-09T00:00:00 | -9.53% | 60.47% |

| 2024-09-10T00:00:00 | 6.65% | 60.47% |

| 2024-09-11T00:00:00 | 6.71% | 57.35% |

| 2024-09-12T00:00:00 | 5.59% | 57.35% |

| 2024-09-13T00:00:00 | 10.42% | 57.35% |

| 2024-09-14T00:00:00 | 23.96% | 57.35% |

| 2024-09-15T00:00:00 | -14.96% | 57.35% |

| 2024-09-16T00:00:00 | -33.08% | 57.35% |

| 2024-09-17T00:00:00 | 64.72% | 57.35% |

| 2024-09-18T00:00:00 | 25.01% | 47.83% |

| 2024-09-19T00:00:00 | 8.57% | 47.83% |

| 2024-09-20T00:00:00 | 10.81% | 47.83% |

| 2024-09-21T00:00:00 | 20.77% | 47.83% |

| 2024-09-22T00:00:00 | -12.82% | 47.83% |

| 2024-09-23T00:00:00 | -18.97% | 47.83% |

| 2024-09-24T00:00:00 | 3.07% | 47.83% |

| 2024-09-25T00:00:00 | 7.08% | 54.93% |

| 2024-09-26T00:00:00 | 1.20% | 54.93% |

| 2024-09-27T00:00:00 | 13.41% | 54.93% |

| 2024-09-28T00:00:00 | 16.98% | 54.93% |

| 2024-09-29T00:00:00 | -10.58% | 54.93% |

| 2024-09-30T00:00:00 | -14.05% | 54.93% |

| 2024-10-01T00:00:00 | -5.05% | 54.93% |

| 2024-10-02T00:00:00 | 7.01% | 38.29% |

| 2024-10-03T00:00:00 | -2.11% | 38.29% |

| 2024-10-04T00:00:00 | 9.31% | 38.29% |

| 2024-10-05T00:00:00 | -10.86% | 38.29% |

| 2024-10-06T00:00:00 | 2.12% | 38.29% |

| 2024-10-07T00:00:00 | -10.33% | 38.29% |

| 2024-10-08T00:00:00 | 21.36% | 38.29% |

| 2024-10-09T00:00:00 | -3.88% | 26.00% |

| 2024-10-10T00:00:00 | 8.23% | 26.00% |

| 2024-10-11T00:00:00 | 13.06% | 26.00% |

| 2024-10-12T00:00:00 | 16.43% | 26.00% |

| 2024-10-13T00:00:00 | -6.35% | 26.00% |

| 2024-10-14T00:00:00 | -21.44% | 26.00% |

| 2024-10-15T00:00:00 | -27.60% | 26.00% |

| 2024-10-16T00:00:00 | 78.64% | 23.95% |

| 2024-10-17T00:00:00 | 7.49% | 23.95% |

| 2024-10-18T00:00:00 | 7.34% | 23.95% |

| 2024-10-19T00:00:00 | 15.11% | 23.95% |

| 2024-10-20T00:00:00 | -9.16% | 23.95% |

| 2024-10-21T00:00:00 | -21.26% | 23.95% |

| 2024-10-22T00:00:00 | 1.68% | 23.95% |

| 2024-10-23T00:00:00 | -58.72% | 25.55% |

| 2024-10-24T00:00:00 | 106.94% | 25.55% |

| 2024-10-25T00:00:00 | 24.09% | 25.55% |

| 2024-10-26T00:00:00 | 13.43% | 25.55% |

| 2024-10-27T00:00:00 | -9.98% | 25.55% |

| 2024-10-28T00:00:00 | -14.73% | 25.55% |

| 2024-10-29T00:00:00 | 5.70% | 25.55% |

| 2024-10-30T00:00:00 | 2.07% | 16.67% |

| 2024-10-31T00:00:00 | 17.20% | 16.67% |

| 2024-11-01T00:00:00 | 15.39% | 16.67% |

| 2024-11-02T00:00:00 | 10.24% | 16.67% |

| 2024-11-03T00:00:00 | -14.32% | 16.67% |

| 2024-11-04T00:00:00 | -8.18% | 16.67% |

| 2024-11-05T00:00:00 | 1.33% | 16.67% |

![Daily Transfer Growth](https://github.com/simeononsecurity/track-helium-mobile-wifi/blob/main/output/daily_transfer_growth.png)

![Daily Subscribers](https://github.com/simeononsecurity/track-helium-mobile-wifi/blob/main/output/daily_subscribers.png)

#### Subscribers Growth

| Date | Daily Growth (%) | Weekly Growth (%) |

| --- | --- | --- |

| 2024-06-26T00:00:00 | 92.65% | 529.90% |

| 2024-06-27T00:00:00 | 15.23% | 529.90% |

| 2024-06-28T00:00:00 | 14.21% | 529.90% |

| 2024-06-29T00:00:00 | 19.50% | 529.90% |

| 2024-06-30T00:00:00 | -6.09% | 529.90% |

| 2024-07-01T00:00:00 | -31.58% | 529.90% |

| 2024-07-02T00:00:00 | 7.16% | 529.90% |

| 2024-07-03T00:00:00 | 19.41% | 222.76% |

| 2024-07-04T00:00:00 | 28.69% | 222.76% |

| 2024-07-05T00:00:00 | 7.27% | 222.76% |

| 2024-07-06T00:00:00 | -12.58% | 222.76% |

| 2024-07-07T00:00:00 | -25.28% | 222.76% |

| 2024-07-08T00:00:00 | -31.80% | 222.76% |

| 2024-07-09T00:00:00 | -12.14% | 222.76% |

| 2024-07-10T00:00:00 | 8.09% | 71.83% |

| 2024-07-11T00:00:00 | 6.74% | 71.83% |

| 2024-07-12T00:00:00 | 19.30% | 71.83% |

| 2024-07-13T00:00:00 | 26.77% | 71.83% |

| 2024-07-14T00:00:00 | -5.03% | 71.83% |

| 2024-07-15T00:00:00 | -36.13% | 71.83% |

| 2024-07-16T00:00:00 | -7.93% | 71.83% |

| 2024-07-17T00:00:00 | 10.92% | 29.48% |

| 2024-07-18T00:00:00 | 8.33% | 29.48% |

| 2024-07-19T00:00:00 | 18.48% | 29.48% |

| 2024-07-20T00:00:00 | 41.41% | 29.48% |

| 2024-07-21T00:00:00 | -11.55% | 29.48% |

| 2024-07-22T00:00:00 | -43.74% | 29.48% |

| 2024-07-23T00:00:00 | -24.74% | 29.48% |

| 2024-07-24T00:00:00 | 0.38% | 22.77% |

| 2024-07-25T00:00:00 | 6.69% | 22.77% |

| 2024-07-26T00:00:00 | 59.86% | 22.77% |

| 2024-07-27T00:00:00 | 49.41% | 22.77% |

| 2024-07-28T00:00:00 | -10.54% | 22.77% |

| 2024-07-29T00:00:00 | -33.62% | 22.77% |

| 2024-07-30T00:00:00 | 0.10% | 22.77% |

| 2024-07-31T00:00:00 | -3.15% | 17.58% |

| 2024-08-01T00:00:00 | 9.73% | 17.58% |

| 2024-08-02T00:00:00 | 28.31% | 17.58% |

| 2024-08-03T00:00:00 | 18.90% | 17.58% |

| 2024-08-04T00:00:00 | -11.55% | 17.58% |

| 2024-08-05T00:00:00 | 7.44% | 17.58% |

| 2024-08-06T00:00:00 | 3.69% | 17.58% |

| 2024-08-07T00:00:00 | 1.13% | 18.67% |

| 2024-08-08T00:00:00 | 9.81% | 18.67% |

| 2024-08-09T00:00:00 | 16.04% | 18.67% |

| 2024-08-10T00:00:00 | 38.28% | 18.67% |

| 2024-08-11T00:00:00 | -12.64% | 18.67% |

| 2024-08-12T00:00:00 | -39.82% | 18.67% |

| 2024-08-13T00:00:00 | -11.65% | 18.67% |

| 2024-08-14T00:00:00 | 6.13% | 22.32% |

| 2024-08-15T00:00:00 | 53.85% | 22.32% |

| 2024-08-16T00:00:00 | 26.48% | 22.32% |

| 2024-08-17T00:00:00 | 34.75% | 22.32% |

| 2024-08-18T00:00:00 | -12.31% | 22.32% |

| 2024-08-19T00:00:00 | -38.74% | 22.32% |

| 2024-08-20T00:00:00 | -4.59% | 22.32% |

| 2024-08-21T00:00:00 | 73.50% | 22.89% |

| 2024-08-22T00:00:00 | 13.39% | 22.89% |

| 2024-08-23T00:00:00 | 19.57% | 22.89% |

| 2024-08-24T00:00:00 | 28.08% | 22.89% |

| 2024-08-25T00:00:00 | -7.81% | 22.89% |

| 2024-08-26T00:00:00 | -37.54% | 22.89% |

| 2024-08-27T00:00:00 | 40.09% | 22.89% |

| 2024-08-28T00:00:00 | 14.18% | 32.96% |

| 2024-08-29T00:00:00 | 8.95% | 32.96% |

| 2024-08-30T00:00:00 | 16.36% | 32.96% |

| 2024-08-31T00:00:00 | 31.66% | 32.96% |

| 2024-09-01T00:00:00 | -4.28% | 32.96% |

| 2024-09-02T00:00:00 | -15.55% | 32.96% |

| 2024-09-03T00:00:00 | -36.26% | 32.96% |

| 2024-09-04T00:00:00 | 5.94% | 37.96% |

| 2024-09-05T00:00:00 | 62.55% | 37.96% |

| 2024-09-06T00:00:00 | 24.98% | 37.96% |

| 2024-09-07T00:00:00 | 27.77% | 37.96% |

| 2024-09-08T00:00:00 | -8.95% | 37.96% |

| 2024-09-09T00:00:00 | -17.80% | 37.96% |

| 2024-09-10T00:00:00 | -14.89% | 37.96% |

| 2024-09-11T00:00:00 | -9.83% | 37.50% |

| 2024-09-12T00:00:00 | 1.47% | 37.50% |

| 2024-09-13T00:00:00 | 18.50% | 37.50% |

| 2024-09-14T00:00:00 | 42.49% | 37.50% |

| 2024-09-15T00:00:00 | -11.37% | 37.50% |

| 2024-09-16T00:00:00 | -48.74% | 37.50% |

| 2024-09-17T00:00:00 | 53.66% | 37.50% |

| 2024-09-18T00:00:00 | 42.25% | 25.92% |

| 2024-09-19T00:00:00 | 0.69% | 25.92% |

| 2024-09-20T00:00:00 | 24.46% | 25.92% |

| 2024-09-21T00:00:00 | 34.55% | 25.92% |

| 2024-09-22T00:00:00 | -8.04% | 25.92% |

| 2024-09-23T00:00:00 | -39.47% | 25.92% |

| 2024-09-24T00:00:00 | -7.42% | 25.92% |

| 2024-09-25T00:00:00 | 9.68% | 34.53% |

| 2024-09-26T00:00:00 | 3.28% | 34.53% |

| 2024-09-27T00:00:00 | 23.59% | 34.53% |

| 2024-09-28T00:00:00 | 35.89% | 34.53% |

| 2024-09-29T00:00:00 | -13.28% | 34.53% |

| 2024-09-30T00:00:00 | -34.01% | 34.53% |

| 2024-10-01T00:00:00 | -4.89% | 34.53% |

| 2024-10-02T00:00:00 | 3.41% | 24.99% |

| 2024-10-03T00:00:00 | 2.12% | 24.99% |

| 2024-10-04T00:00:00 | 11.56% | 24.99% |

| 2024-10-05T00:00:00 | 9.35% | 24.99% |

| 2024-10-06T00:00:00 | -4.72% | 24.99% |

| 2024-10-07T00:00:00 | -16.67% | 24.99% |

| 2024-10-08T00:00:00 | 41.35% | 24.99% |

| 2024-10-09T00:00:00 | -2.65% | 18.36% |

| 2024-10-10T00:00:00 | 3.40% | 18.36% |

| 2024-10-11T00:00:00 | 15.22% | 18.36% |

| 2024-10-12T00:00:00 | 35.82% | 18.36% |

| 2024-10-13T00:00:00 | 0.95% | 18.36% |

| 2024-10-14T00:00:00 | -31.95% | 18.36% |

| 2024-10-15T00:00:00 | -32.36% | 18.36% |

| 2024-10-16T00:00:00 | 92.52% | 22.07% |

| 2024-10-17T00:00:00 | 11.19% | 22.07% |

| 2024-10-18T00:00:00 | 17.08% | 22.07% |

| 2024-10-19T00:00:00 | 30.02% | 22.07% |

| 2024-10-20T00:00:00 | -2.61% | 22.07% |

| 2024-10-21T00:00:00 | -29.11% | 22.07% |

| 2024-10-22T00:00:00 | 0.91% | 22.07% |

| 2024-10-23T00:00:00 | -59.52% | 28.57% |

| 2024-10-24T00:00:00 | 100.11% | 28.57% |

| 2024-10-25T00:00:00 | 37.72% | 28.57% |

| 2024-10-26T00:00:00 | 17.47% | 28.57% |

| 2024-10-27T00:00:00 | -0.14% | 28.57% |

| 2024-10-28T00:00:00 | -22.40% | 28.57% |

| 2024-10-29T00:00:00 | 0.61% | 28.57% |

| 2024-10-30T00:00:00 | 14.31% | 20.11% |

| 2024-10-31T00:00:00 | 45.72% | 20.11% |

| 2024-11-01T00:00:00 | 37.34% | 20.11% |

| 2024-11-02T00:00:00 | 7.67% | 20.11% |

| 2024-11-03T00:00:00 | -8.89% | 20.11% |

| 2024-11-04T00:00:00 | -8.90% | 20.11% |

| 2024-11-05T00:00:00 | 15.05% | 20.11% |

![Daily Subscribers Growth](https://github.com/simeononsecurity/track-helium-mobile-wifi/blob/main/output/daily_subscribers_growth.png)

![Daily Hotspots Serving Carrier Partners](https://github.com/simeononsecurity/track-helium-mobile-wifi/blob/main/output/daily_hotspots_serving.png)

#### Hotspots Growth

| Date | Daily Growth (%) | Weekly Growth (%) |

| --- | --- | --- |

| 2024-06-25T00:00:00 | 4.35% | -4.00% |

| 2024-06-26T00:00:00 | 12.50% | -4.00% |

| 2024-06-27T00:00:00 | 7.41% | -4.00% |

| 2024-06-28T00:00:00 | 0.00% | -4.00% |

| 2024-06-29T00:00:00 | -3.45% | -4.00% |

| 2024-06-30T00:00:00 | -14.29% | -4.00% |

| 2024-07-01T00:00:00 | 4.17% | -4.00% |

| 2024-07-02T00:00:00 | -4.00% | 0.00% |

| 2024-07-03T00:00:00 | 4.17% | 0.00% |

| 2024-07-04T00:00:00 | -4.00% | 0.00% |

| 2024-07-05T00:00:00 | 0.00% | 0.00% |

| 2024-07-06T00:00:00 | 0.00% | 0.00% |

| 2024-07-07T00:00:00 | -4.17% | 0.00% |

| 2024-07-08T00:00:00 | 4.35% | 0.00% |

| 2024-07-09T00:00:00 | -4.17% | -4.17% |

| 2024-07-10T00:00:00 | -4.35% | -4.17% |

| 2024-07-11T00:00:00 | 0.00% | -4.17% |

| 2024-07-12T00:00:00 | 4.55% | -4.17% |

| 2024-07-13T00:00:00 | 0.00% | -4.17% |

| 2024-07-14T00:00:00 | 0.00% | -4.17% |

| 2024-07-15T00:00:00 | 0.00% | -4.17% |

| 2024-07-16T00:00:00 | 0.00% | 0.00% |

| 2024-07-17T00:00:00 | 4.35% | 0.00% |

| 2024-07-18T00:00:00 | -4.17% | 0.00% |

| 2024-07-19T00:00:00 | 0.00% | 0.00% |

| 2024-07-20T00:00:00 | 4.35% | 0.00% |

| 2024-07-21T00:00:00 | -4.17% | 0.00% |

| 2024-07-22T00:00:00 | -4.35% | 0.00% |

| 2024-07-23T00:00:00 | 4.55% | 0.00% |

| 2024-07-24T00:00:00 | -4.35% | 0.00% |

| 2024-07-25T00:00:00 | 4.55% | 0.00% |

| 2024-07-26T00:00:00 | 8.70% | 0.00% |

| 2024-07-27T00:00:00 | -8.00% | 0.00% |

| 2024-07-28T00:00:00 | 0.00% | 0.00% |

| 2024-07-29T00:00:00 | 26.09% | 0.00% |

| 2024-07-30T00:00:00 | -6.90% | 17.39% |

| 2024-07-31T00:00:00 | 3.70% | 17.39% |

| 2024-08-01T00:00:00 | -3.57% | 17.39% |

| 2024-08-02T00:00:00 | 3.70% | 17.39% |

| 2024-08-03T00:00:00 | -3.57% | 17.39% |

| 2024-08-04T00:00:00 | 0.00% | 17.39% |

| 2024-08-05T00:00:00 | 214.81% | 17.39% |

| 2024-08-06T00:00:00 | -1.18% | 211.11% |

| 2024-08-07T00:00:00 | 2.38% | 211.11% |

| 2024-08-08T00:00:00 | 0.00% | 211.11% |

| 2024-08-09T00:00:00 | 3.49% | 211.11% |

| 2024-08-10T00:00:00 | -5.62% | 211.11% |

| 2024-08-11T00:00:00 | 1.19% | 211.11% |

| 2024-08-12T00:00:00 | 4.71% | 211.11% |

| 2024-08-13T00:00:00 | -5.62% | 0.00% |

| 2024-08-14T00:00:00 | 1.19% | 0.00% |

| 2024-08-15T00:00:00 | 75.29% | 0.00% |

| 2024-08-16T00:00:00 | 0.00% | 0.00% |

| 2024-08-17T00:00:00 | -2.68% | 0.00% |

| 2024-08-18T00:00:00 | -0.69% | 0.00% |

| 2024-08-19T00:00:00 | 0.69% | 0.00% |

| 2024-08-20T00:00:00 | 2.07% | 76.19% |

| 2024-08-21T00:00:00 | 89.86% | 76.19% |

| 2024-08-22T00:00:00 | 3.20% | 76.19% |

| 2024-08-23T00:00:00 | -4.48% | 76.19% |

| 2024-08-24T00:00:00 | -1.81% | 76.19% |

| 2024-08-25T00:00:00 | -1.10% | 76.19% |

| 2024-08-26T00:00:00 | 1.12% | 76.19% |

| 2024-08-27T00:00:00 | 56.62% | 187.84% |

| 2024-08-28T00:00:00 | 0.23% | 187.84% |

| 2024-08-29T00:00:00 | 14.99% | 187.84% |

| 2024-08-30T00:00:00 | -4.28% | 187.84% |

| 2024-08-31T00:00:00 | -2.55% | 187.84% |

| 2024-09-01T00:00:00 | -1.31% | 187.84% |

| 2024-09-02T00:00:00 | 1.33% | 187.84% |

| 2024-09-03T00:00:00 | 2.40% | 10.09% |

| 2024-09-04T00:00:00 | 0.85% | 10.09% |

| 2024-09-05T00:00:00 | 61.52% | 10.09% |

| 2024-09-06T00:00:00 | 9.55% | 10.09% |

| 2024-09-07T00:00:00 | -0.96% | 10.09% |

| 2024-09-08T00:00:00 | -1.93% | 10.09% |

| 2024-09-09T00:00:00 | 34.07% | 10.09% |

| 2024-09-10T00:00:00 | 1.28% | 135.39% |

| 2024-09-11T00:00:00 | -1.54% | 135.39% |

| 2024-09-12T00:00:00 | 0.64% | 135.39% |

| 2024-09-13T00:00:00 | -0.46% | 135.39% |

| 2024-09-14T00:00:00 | -1.47% | 135.39% |

| 2024-09-15T00:00:00 | -3.17% | 135.39% |

| 2024-09-16T00:00:00 | 37.54% | 135.39% |

| 2024-09-17T00:00:00 | 2.73% | 32.97% |

| 2024-09-18T00:00:00 | 3.75% | 32.97% |

| 2024-09-19T00:00:00 | -0.72% | 32.97% |

| 2024-09-20T00:00:00 | -1.12% | 32.97% |

| 2024-09-21T00:00:00 | -0.20% | 32.97% |

| 2024-09-22T00:00:00 | -3.02% | 32.97% |

| 2024-09-23T00:00:00 | 3.94% | 32.97% |

| 2024-09-24T00:00:00 | 0.13% | 2.59% |

| 2024-09-25T00:00:00 | 12.95% | 2.59% |

| 2024-09-26T00:00:00 | -0.29% | 2.59% |

| 2024-09-27T00:00:00 | -0.24% | 2.59% |

| 2024-09-28T00:00:00 | -3.37% | 2.59% |

| 2024-09-29T00:00:00 | -0.73% | 2.59% |

| 2024-09-30T00:00:00 | 0.80% | 2.59% |

| 2024-10-01T00:00:00 | -0.24% | 8.37% |

| 2024-10-02T00:00:00 | 1.10% | 8.37% |

| 2024-10-03T00:00:00 | -0.79% | 8.37% |

| 2024-10-04T00:00:00 | 1.16% | 8.37% |

| 2024-10-05T00:00:00 | -4.29% | 8.37% |

| 2024-10-06T00:00:00 | -2.90% | 8.37% |

| 2024-10-07T00:00:00 | 22.09% | 8.37% |

| 2024-10-08T00:00:00 | 6.76% | 22.92% |

| 2024-10-09T00:00:00 | -0.30% | 22.92% |

| 2024-10-10T00:00:00 | -0.90% | 22.92% |

| 2024-10-11T00:00:00 | -0.05% | 22.92% |

| 2024-10-12T00:00:00 | -2.57% | 22.92% |

| 2024-10-13T00:00:00 | -2.49% | 22.92% |

| 2024-10-14T00:00:00 | 5.26% | 22.92% |

| 2024-10-15T00:00:00 | 11.86% | 10.47% |

| 2024-10-16T00:00:00 | 11.01% | 10.47% |

| 2024-10-17T00:00:00 | 1.06% | 10.47% |

| 2024-10-18T00:00:00 | 1.53% | 10.47% |

| 2024-10-19T00:00:00 | -3.96% | 10.47% |

| 2024-10-20T00:00:00 | -3.71% | 10.47% |

| 2024-10-21T00:00:00 | 7.80% | 10.47% |

| 2024-10-22T00:00:00 | 4.85% | 19.04% |

| 2024-10-23T00:00:00 | -10.73% | 19.04% |

| 2024-10-24T00:00:00 | 8.70% | 19.04% |

| 2024-10-25T00:00:00 | 1.05% | 19.04% |

| 2024-10-26T00:00:00 | -2.01% | 19.04% |

| 2024-10-27T00:00:00 | -4.54% | 19.04% |

| 2024-10-28T00:00:00 | 6.40% | 19.04% |

| 2024-10-29T00:00:00 | 0.78% | -1.63% |

| 2024-10-30T00:00:00 | -1.85% | -1.63% |

| 2024-10-31T00:00:00 | 19.71% | -1.63% |

| 2024-11-01T00:00:00 | 0.85% | -1.63% |

| 2024-11-02T00:00:00 | -4.46% | -1.63% |

| 2024-11-03T00:00:00 | -4.59% | -1.63% |

| 2024-11-04T00:00:00 | 5.60% | -1.63% |

| 2024-11-05T00:00:00 | -0.17% | 13.87% |

![Daily Hotspots Growth](https://github.com/simeononsecurity/track-helium-mobile-wifi/blob/main/output/daily_hotspots_growth.png)

## Wigle Net Sourced Status

### Helium Mobile WiFi Stats Table

| Statistic | Count | Description |

|-----------|-------|-------------|

| Total APs | 8335 | Total count of all Hotspot 2.0 access points |

| Residential Locations | 4234 | 50.80% of total locations |

| Business Locations | 4067 | 48.79% of total locations |

| OpenRoaming Unsettled | 3 | Count of devices with RCOI matching any OpenRoaming unsettled RCOI |

| OpenRoaming Settled | 3 | Count of devices with RCOI matching any OpenRoaming settled RCOI |

| Google Orion Devices | 14 | Count of devices with RCOI containing 'f4f5e8f5f4' |

| IronWiFi Devices | 3 | Count of devices with RCOI containing 'aa146b0000' |

| Helium Devices | 7186 | Count of devices with SSID containing 'Helium Mobile' |

| Helium Free WiFi Devices | 1149 | Count of devices with SSID containing 'Helium Free Wi-Fi' |

| Other Devices | 0 | Count of devices that do not match any of the above categories |

### SSIDS Tracked

| SSID | Count |

|------|-------|

| Helium Mobile | 7186 |

| Helium Free Wi-Fi | 1149 |

### Unique RCOIs

| RCOI | Definition | Count |

|------|------------|-------|

| 0 | Unknown | 8166 |

| nan | Unknown | 152 |

| f4f5e8f5f4 | Google Orion Devices | 14 |

| aa146b0000 | IronWiFi Devices | 3 |

| baa2d00000 | OpenRoaming Settled | 3 |

| 5a03ba0000 | OpenRoaming Unsettled (All) | 3 |

## Installation

1. Clone the repository:

   ```sh

   git clone https://github.com/yourusername/track-helium-mobile-wifi.git

   cd track-helium-mobile-wifi

   ```

2. Set up a virtual environment and activate it:

   ```sh

   python -m venv venv

   source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

   ```

3. Install the required dependencies:

   ```sh

   pip install -r requirements.txt

   ```

4. Create a `.env` file in the root directory with your API credentials:

   ```env

   API_NAME=your_api_name

   API_TOKEN=your_api_token

   AUTH_HEADER=your_auth_header

   ```

## Usage

### Scripts

#### map_wigle_devices.py

Fetches data from the WiGLE API and saves it to a CSV file.

#### filter_sort_wigle_results.py

Filters and sorts the fetched WiGLE results and processes them for further analysis.

#### generate_map_html.py

Generates an interactive HTML map using Folium, displaying WiGLE data points. The HTML map files are saved to the `Output` directory and an `archive` subdirectory with the current year appended.

#### generate_map_png.py

Generates a static PNG map using Matplotlib and Basemap, displaying WiGLE data points. The PNG map files are saved to the `Output` directory and an `archive` subdirectory with the current year appended.

#### update_readme_stats.py

Updates the `README.md` file with statistics about the WiGLE data.

#### classify_locations.py

Classifies SSIDs from the WiGLE data as Residential, Business, or Public based on heuristics and performs reverse geocoding to add location information. The results are saved to a new CSV file.

### Running the Scripts

1. **Fetch data from WiGLE**:

   ```sh

   python scripts/map_wigle_devices.py

   ```

2. **Filter and sort the results**:

   ```sh

   python scripts/filter_sort_wigle_results.py

   ```

3. **Generate the HTML map**:

   ```sh

   python scripts/generate_map_html.py

   ```

4. **Generate the PNG map**:

   ```sh

   python scripts/generate_map_png.py

   ```

5. **Classify SSIDs and perform reverse geocoding**:

   ```sh

   python scripts/classify_locations.py

   ```

6. **Update the README with statistics**:

   ```sh

   python scripts/update_readme_stats.py

   ```

## Automated Workflow

The project includes a GitHub Actions workflow that runs the scripts automatically every 24 hours and updates the repository.

## GitHub Pages

The HTML maps are made available through GitHub Pages. The workflow ensures the HTML files are copied to the `docs` folder, which is configured for GitHub Pages.

## Contributing

Contributions are welcome! Please open an issue or submit a pull request.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.