This projects listens to the APRS-servers of the Open Glider Network and keeps track of all incoming aircraft status. It provides an API that returns the latest status for each aircraft within a given location and range. It also provides a simple website that fetches and lists those aircraft status based on your device location automatically.
cd backend/cargo build --release
cd frontend/npm run copy-dependenciesnpm run compile
- Either run
RUST_LOG=error cargo runinside the backend/ directory or build the backend and runRUST_LOG=error ./backend/target/release/above_me. - Build the frontend and serve the frontend/dist directory.
(For development, you may run
npm run devinside the frontend/ directory. Requires Python 3.)
Only the backend must be configured. Frontend will run as-is. There are three ways for configuration:
- /config.json (copy config.example.json)
- /backend/config.json (copy config.example.json, overrides 1.)
- by environment variables with the prefix ABOVE_ME__ (see /docker/.env.example, overrides 1. and 2.)
Configure by setting up /docker/.env (copy /docker/.env.example) and run docker compose up.
(Please note that the bind_url should be left unconfigured as it is used in the /docker/docker-compose.yml config file. Otherwise the proxy-pass may break.)
The website contains links to privacy-policy.html. You can (and should) set up this privacy policy page. Empty dummy files already exist in the docker/ and frontend/src/ directories.
API-Documentation: openapi.yml
This project is up and running. I'd say it's "feature-complete" for my use-case. I'll maybe start building a nicer frontend sometimes. (see TODO.md)
This code is licensed under the MIT-License (see LICENSE). Before using it, make sure to not violate against OGN rules:
see OGN data usage
see ODbL summary
(This project complies to those rules by only publishing data that's at most 5 minutes old and only for aircraft that don't have stealth- or no-tracking-mode active.)