How dennisfaucher/flightstatus works
Flight Status is a self-hosted tracker: a user adds a flight and local departure date, the Flask app fetches and normalizes flight data, then a background worker refreshes it, tracks changes, and sends alerts. Users view and manage their own flights through a polled dashboard. The README documents adaptive refresh, budget limits, cleanup, login, and email behavior; source excerpts show provider lookup, normalization, and alert components. Some worker and route details are unsampled, so their connections rely on README statements.
Main entry points: app.py Flight management API · providers.py Provider lookup and normalization · app.js Dashboard interaction · mailer.py SMTP delivery
Components 16
Web experience
- Web browser
- Flight dashboard
templates/index.html - Login page
templates/login.html - Dashboard interaction
static/app.js
Flight tracking
- Flask application
app.py - User access
app.py - Flight management API
app.py - Refresh and cleanup
app.py - Flight state file
app.py - Provider lookup and normalization
providers.py
Alerts
- Change detection and rendering
alerts.py - SMTP delivery
mailer.py
External services
- FlightAware AeroAPI
- airframes.io fallback
- SMTP server
Other components
- Tracker user
Connections 20
- Tracker user → Web browser: uses
README.md - Web browser → Flight dashboard: opens
README.md - Web browser → Login page: signs in
README.md - Flight dashboard → Dashboard interaction: loads
README.md - Dashboard interaction → Flight management API: requests flights
static/app.js - Dashboard interaction → Flight management API: adds, refreshes, removes
static/app.js - Tracker user → User access: authenticates
README.md - User access → Flight management API: restricts access
README.md - Flight management API → Provider lookup and normalization: looks up flight
app.py - Refresh and cleanup → Provider lookup and normalization: fetches updates
README.md - Provider lookup and normalization → FlightAware AeroAPI: queries
providers.py - Provider lookup and normalization → airframes.io fallback: falls back
README.md - Refresh and cleanup → Flight state file: reads and writes
README.md - Refresh and cleanup → Change detection and rendering: checks changes; renders alerts
README.md - Flask application → Refresh and cleanup: runs refresh worker
README.md - Flask application → Flight management API: serves endpoints
README.md - Flask application → User access: provides login
README.md - Flask application → SMTP delivery: wires alert delivery
README.md - SMTP delivery → SMTP server: sends email
mailer.py - Change detection and rendering → SMTP delivery: formats messages for