WiGLE service integration for Exist.io

Track your daily signal discoveries for cell, WiFi, and Bluetooth in WiGLE as attributes in Exist.io.

Setup

Install a copy of the repository:

git clone --recurse-submodules https://codeberg.org/da/exist.io-wigle.git

How it works

The program submits data to Exist and then exits. It needs to be run at least once per day (a few minutes before midnight in your local time zone). On every run, it checks for and counts newly discovered networks in your WiGLE account, and submits those counts to Exist.

It is recommended that you use the provided systemd unit files to manage the program’s lifecycle. It will run the program every four hours during the day, plus just before midnight.

Configuration

Provide configuration options as environmental variables. All configuration options are required.

EXIST_CLIENT_ID=
EXIST_CLIENT_SECRET=
EXIST_OAUTH2_RETURN="http://localhost:9009/"
WIGLE_USERNAME=
WIGLE_ENCODED_API_TOKEN=

You can obtain the two first values and supply the third by registering your client as an Exist app.

You can find your WiGLE API token on your WiGLE Account page.

systemd

The systemd directory contains example systemd service unit files for running the program periodically as a systemd service. You may need to adjust the paths to the ExecStart program and the EnvironmentFile file where you store your config.