-
Notifications
You must be signed in to change notification settings - Fork 18
Settings
Everything is configurable on the touchscreen: tap the gear icon in the header. The same settings (plus keyboard-friendly extras) live in the Web Panel Settings tab. Fields marked (restart) apply after the automatic restart on Save; everything else applies immediately.
Five tabs: Network, Location, Filters, Integrations, System.
| Setting | What it does |
|---|---|
| Wi-Fi SSID | Pick from the scan list (2.4 GHz networks only) |
| Password | Network password |
If a connection fails, the status line tells you why (wrong password vs. network not found).

| Setting | What it does |
|---|---|
| Auto location (IP) | Locate by public IP, usually city-accurate |
| City search | Type a city name, pick from results; also accepts airport codes (ICAO/IATA) to center exactly on an airport |
| Latitude / Longitude | Manual coordinates, for when you know exactly where you are |
| Search radius | 1 to 250 NM around the center; this is the radar circle |
City search understands native names ("München", "Warszawa") and searches in the device language.

Traffic
| Setting | What it does |
|---|---|
| Hide ground | Drop aircraft taxiing or parked (recommended near airports) |
| Airline only | Only aircraft with a recognized airline, hides most private traffic |
| Airport only (ICAO/IATA) | Only flights to or from one airport, with a Show only / Hide switch |
| Alt from / Alt to (ft) | Altitude band; 0 = no limit |
Watchlist
Comma-separated registration or callsign prefixes (e.g. SP-LR,RCH,A388); matches are highlighted in gold and push-notified. See Integrations.
Flyover alerts
Flyover alerts (CPA): a push a few minutes before an aircraft passes nearly overhead, with an Interesting only / All aircraft scope switch. Needs the ntfy topic from the Integrations tab.
Aircraft classes
Pick any mix of Airliner, Light, Helicopter, Military and Other. The class also colors the type code in the list and the markers on maps.

The keyboard-heavy fields, covered in detail on the Integrations page: ntfy.sh push topic, webhook URL, FlightAware key, local dump1090/readsb receiver URL, MQTT broker, plus the two layer keys (openAIP, aisstream.io).

Appearance
| Setting | What it does |
|---|---|
| Theme | 7 color themes |
| Language | English / Polski |
| Units | Aviation (ft, kt) or Metric (m, km/h) |
| METAR | Raw or Decoded (plain-language wind, visibility, clouds) |
| Auto-cycle through flights | Off = pin and follow one flight |
Screen
| Setting | What it does |
|---|---|
| Night mode | Dimmed dark palette, manual hours (From/To) or Auto (sunset to sunrise, computed for your location) |
| Map screensaver after (min) | Idle minutes before ambient mode, 0 = off |
| Screensaver style | Sky map or Retro radar |
| Brighter map tiles | Lifts the dark basemap for readable street detail |
Layers are described on their own page: rain radar, airspace zones, ISS, weather balloons, ships, TAF, with the two API key fields.
Web panel
| Setting | What it does |
|---|---|
| Web panel password | HTTP Basic Auth for the panel and API; empty = open |
Updates
| Setting | What it does |
|---|---|
| Allow OTA updates (until restart) | Arms the OTA endpoint; re-locks on every restart. Applies immediately, do not tap Save, just close the settings. |
See Updating for the full update story.
- Save restarts the device with the new configuration. Switches marked as immediate (OTA unlock, theme preview) work without saving.
- The full configuration can be backed up and restored from the web panel.
esp32flight - MIT (c) theqkash | Flash from your browser | Discord | Support on Ko-fi
Setup
Using it
Reference
Links