https://github.com/simeononsecurity/track-openroaming-passpoint
A collection of scripts and tools that tracks the availability of hotspot 2.0, passpoint, and openroaming networks in the wild from the Wigle Dataset. Updates every 24 hours. Resets and archives yearly.
https://github.com/simeononsecurity/track-openroaming-passpoint
anp carrier-offload guest-wifi hotspot-wifi idp openroaming passpoint wifi wifi-configuration wifi-hotspot wifi-security
Last synced: 4 months ago
JSON representation
A collection of scripts and tools that tracks the availability of hotspot 2.0, passpoint, and openroaming networks in the wild from the Wigle Dataset. Updates every 24 hours. Resets and archives yearly.
- Host: GitHub
- URL: https://github.com/simeononsecurity/track-openroaming-passpoint
- Owner: simeononsecurity
- License: mit
- Created: 2024-07-21T04:41:18.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2026-01-23T00:22:50.000Z (4 months ago)
- Last Synced: 2026-01-23T17:37:55.855Z (4 months ago)
- Topics: anp, carrier-offload, guest-wifi, hotspot-wifi, idp, openroaming, passpoint, wifi, wifi-configuration, wifi-hotspot, wifi-security
- Language: HTML
- Homepage: https://openroamingmap.simeononsecurity.com/
- Size: 658 MB
- Stars: 9
- Watchers: 3
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Track OpenRoaming Passpoint
[](https://github.com/sponsors/simeononsecurity) [](https://openroamingmap.simeononsecurity.com) [](https://dune.com/simeononsecurity/openroaming)
A collection of scripts and tools that tracks the availability of Hotspot 2.0, Passpoint, and OpenRoaming networks in the wild.
Pulls from the Wigle.net dataset.
> **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.
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.
### OpenRoaming and Hotspot 2.0 Stats Table
| Statistic | Count | Description |
|-----------|-------|-------------|
| Total Hotspot 2.0 APs | 26241 | Total count of all Hotspot 2.0 access points |
| OpenRoaming Unsettled | 7001 | Count of devices with RCOI matching any OpenRoaming unsettled RCOI |
| OpenRoaming Settled | 299 | Count of devices with RCOI matching any OpenRoaming settled RCOI |
| eduroam Devices | 629 | Count of devices with RCOI containing either '5A03BA0800' or '1BC50460' or with an SSID matching "eduroam" |
| Google Orion Devices | 11742 | Count of devices with RCOI containing 'f4f5e8f5f4' |
| IronWiFi Devices | 165 | Count of devices with RCOI containing 'aa146b0000' |
| XNET Devices | 237 | Count of devices with SSID containing 'XNET' |
| Helium Devices | 16 | Count of devices with SSID containing 'Helium Mobile' |
| Wayru Devices | 0 | Count of devices with SSID containing 'Wayru' |
| MetaBlox Devices | 8 | Count of devices with SSID containing 'MetaBlox' |
| Cityroam Devices | 911 | Count of devices with SSID containing 'cityroam' |
| Other Devices | 12420 | Count of devices that do not match any of the above categories |
### Most Common RCOI Enabled SSIDs
| SSID | Count |
|------|-------|
| BoldynPasspoint | 3580 |
| LiveBetter | 3034 |
| Cellular Wi-Fi Passthrough | 2110 |
| Xfinity Mobile | 2003 |
| .p | 1692 |
| adco | 1067 |
| Passpoint WiFi | 972 |
| GPGMS_CarrierOffloading | 958 |
| Orion | 923 |
| cityroam | 909 |
### Unique RCOIs
| RCOI | Definition | Count |
|------|------------|-------|
| f4f5e8f5f4 | Google Orion Devices | 11742 |
| 5a03ba0000 | OpenRoaming Unsettled (All) | 6814 |
| 4096 | OpenRoaming Unsettled Legacy / Samsung OneUI (All) | 6802 |
| cae505 | Unknown | 4008 |
| 310410 | ATT Offload ? | 3895 |
| 313100 | ATT Offload ? | 3895 |
| 310280 | ATT Offload ? | 3873 |
| 2233445566 | Unknown | 1314 |
| 21122 | Unknown | 1220 |
| 3af521 | SingleDigits Testing RCOI | 989 |
| f4f5e8f5c4 | Unknown | 920 |
| 1bc50460 | Eduroam Legacy | 614 |
| 6a1f6c | Unknown | 533 |
| 5a03ba | Unknown | 451 |
| 1834af | Unknown | 290 |
| baa2d00000 | Unknown | 283 |
| aa146b0000 | IronWiFi Devices | 165 |
| c6f9c | Unknown | 134 |
| baa2d0 | Unknown | 99 |
| 500f | OpenRoaming Settled Legacy (All paid members) | 97 |
| 8c1f6467b4 | Unknown | 54 |
| 1bc504bd | Unknown | 50 |
| 506f9a | Unknown | 50 |
| 3213445172 | Unknown | 44 |
| baa2d00100 | OpenRoaming Settled (SP paid Bronze QoS) | 39 |
| 24e4ce | Unknown | 29 |
| 5a03ba1000 | OpenRoaming Unsettled (All with real ID) | 29 |
| 1bc5046f | Unknown | 28 |
| aa146b | Unknown | 27 |
| c | Unknown | 25 |
| 1122330000 | Unknown | 18 |
| 500b | OpenRoaming Unsettled Legacy (All with real ID) | 13 |
| 3af050201 | Unknown | 11 |
| 5a03ba0800 | OpenRoaming Unsettled (Education or Research ID free) | 7 |
| 5a03ba0100 | OpenRoaming Unsettled (SP free Bronze QoS) | 4 |
| 583039 | Unknown | 2 |
| 743aef | Unknown | 2 |
| baa2d06000 | Unknown | 2 |
| 840112 | Unknown | 2 |
| 40202 | Unknown | 2 |
| 5a03ba0600 | OpenRoaming Unsettled (Loyalty Hospitality) | 2 |
| 445566 | Unknown | 1 |
| da9d490000 | Unknown | 1 |
| 112233 | Unknown | 1 |
| f4f5e8f5d4 | Alternative Orion Offload? | 1 |
| f4f5e8f5e4 | Alternative Orion Offload? | 1 |
| a43 | Unknown | 1 |
| da9d490005 | Unknown | 1 |
| 5745 | Unknown | 1 |
### OpenRoaming and Hotspot 2.0 Table Mapped
## Table of Contents
- [Track OpenRoaming Passpoint](#track-openroaming-passpoint)
- [OpenRoaming and Hotspot 2.0 Stats Table](#openroaming-and-hotspot-20-stats-table)
- [Most Common RCOI Enabled SSIDs](#most-common-rcoi-enabled-ssids)
- [Unique RCOIs](#unique-rcois)
- [OpenRoaming and Hotspot 2.0 Table Mapped](#openroaming-and-hotspot-20-table-mapped)
- [Table of Contents](#table-of-contents)
- [Introduction](#introduction)
- [Installation](#installation)
- [Usage](#usage)
- [Scripts](#scripts)
- [map\_wigle\_devices.py](#map_wigle_devicespy)
- [filter\_sort\_wigle\_results.py](#filter_sort_wigle_resultspy)
- [generate\_map\_html.py](#generate_map_htmlpy)
- [generate\_map\_png.py](#generate_map_pngpy)
- [update\_readme\_stats.py](#update_readme_statspy)
- [classify\_locations.py](#classify_locationspy)
- [Running the Scripts](#running-the-scripts)
- [Automated Workflow](#automated-workflow)
- [Workflow: `.github/workflows/update_statistics.yml`](#workflow-githubworkflowsupdate_statisticsyml)
- [GitHub Pages](#github-pages)
- [Contributing](#contributing)
- [License](#license)
## Introduction
This project aims to track the availability of Hotspot 2.0, Passpoint, and OpenRoaming networks using data collected from WiGLE and other sources. The collected data is processed and visualized using various scripts.
## Installation
1. Clone the repository:
```sh
git clone https://github.com/yourusername/track-openroaming-passpoint.git
cd track-openroaming-passpoint
```
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. **Update the README with statistics**:
```sh
python scripts/update_readme_stats.py
```
6. **Classify SSIDs and perform reverse geocoding**:
```sh
python scripts/classify_locations.py
```
## Automated Workflow
The project includes a GitHub Actions workflow that runs the scripts automatically every 24 hours and updates the repository.
### Workflow: `.github/workflows/update_statistics.yml`
- Installs the pip requirements.
- Runs the scripts in order:
- `map_wigle_devices.py`
- `generate_map_html.py`
- `generate_map_png.py`
- `update_readme_stats.py`
- Commits the changes back to 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.