A small desktop flight radar built with an ESP32 and a round display.
The radar shows live aircraft positions around your location using data from the OpenSky Network. Aircraft are displayed as moving markers with direction indicators and flight information.
- Live aircraft tracking
- Aircraft positions updated automatically
- Flight direction indicators
- Aircraft details on screen
- Configurable radar range
- OpenSky Network API support
- Works with or without an OpenSky API account
- Mobile-friendly configuration webpage
- Animated aircraft movement between updates
- 3D printable desktop enclosure
- ESP32-S3 super-mini
- Round TFT display
- USB cable
- 3D printed enclosure
- Wi-Fi connection
The STL files for the enclosure are included in this repository.
Print the following parts:
- Base
- Display holder
Recommended material:
- PLA
- Layer height: 0.2 mm
- Infill: 15–20%
- Clone this repository.
- Open the project in Arduino IDE.
- Install all required libraries.
- Select your ESP32 board.
- Compile and upload the firmware.
- WiFi
- WebServer
- ArduinoJson
- TFT_eSPI
- HTTPClient
Additional display libraries may be required depending on your display hardware.
After the first start, connect to the device configuration page.
Configure:
- Wi-Fi SSID
- Wi-Fi password
- Latitude
- Longitude
- Radar range
- OpenSky username (optional)
- OpenSky password or API key (optional)
If no OpenSky credentials are provided, the radar will use the public API limits.
Aircraft data is provided by:
Creating a free account allows higher request limits and better availability.
The direction line indicates the current flight path.
- The ESP32 downloads aircraft data from OpenSky Network.
- Aircraft inside the selected radius are filtered.
- Positions are converted to radar coordinates.
- Aircraft are displayed on the radar screen.
- Between updates, aircraft positions are smoothly animated based on their current speed and heading.