A weather display for the ESP32 CYD (Cheap Yellow Display) using Open-Meteo for weather data and Nominatim for location lookup. No API keys or subscriptions required.
Originally based on Bodmer's DarkSkyWeather, significantly extended and adapted by WabbitGuy.
- ESP32 CYD (Cheap Yellow Display) — 2.8" 240×320 TFT with XPT2046 touchscreen
- The board used and tested is the ST7789-based CYD. Earlier boards used an ILI9341 driver — check the back of your board before ordering.
- Live weather from Open-Meteo — updates every 15 minutes, no subscription, no API key
- Location lookup via Nominatim — city name displayed automatically from coordinates
- 8-day forecast with tap-to-page (days 1–4 or days 5–8), with option to start from today
- 6-hour rotating forecast showing precipitation probability, temperature and dew point
- Current conditions: temperature, wind speed/direction, UV index, cloud cover, humidity
- Moon phase display with correct hemisphere orientation (northern/southern)
- Sunrise/sunset times with automatic backlight dimming at dusk
- Dual location support — tap the BIG weather icon area to toggle between two locations
- Automatic timezone detection via timeapi.io — no hardcoding required
- Timezone offsets self-correct at 2am daily for both locations
- Full web configuration interface — no need to edit code for normal setup
- Map-based location selection with search box (type "London UK" to jump there)
- Multilingual: English, French, German, Spanish, Dutch, Portuguese, Turkish
- Temperature and precipitation threshold colours — fully user configurable
- WiFi management via WiFiManager captive portal
The display has three touch-sensitive areas:
┌─────────────────────────┐
│ Clock / date area │ Tap → About / splash screen
├─────────────────────────┤
│ Weather icon, temp, │ Tap → Toggle between TZ1 and TZ2 locations
│ wind, city name │
├─────────────────────────┤
│ MON TUE WED THU │ Tap → Toggle forecast page (days 1-4 / days 5-8)
└─────────────────────────┘
Access the configuration page at http://wabbitweather.local (or the device IP address) from any browser on the same network.
Set up to two locations using the interactive map. Click or drag the pin, or type a city name in the search box. The timezone offset is detected automatically from the coordinates — no manual timezone selection needed.
TZ1 is your primary location. TZ2 is an alternate location (family in another city, a vacation property, etc.). Tap the weather icon area on the display to switch between them.
- Imperial (°F) or Metric (°C)
- 12 or 24 hour clock
- Auto dim at dusk (uses sunrise/sunset times for the active location)
- Night brightness (0 = display off, 255 = full brightness)
- Show/hide barometric pressure, precipitation probability, UV index, 6hr forecast
- Forecast start: Today or Tomorrow
- Weather and astrology heading colours
Set high and low temperature thresholds and choose colours for each range. Values are in whichever units you selected (°F or °C).
Set high and low precipitation probability thresholds and choose colours for each range.
WabbitWeather uses a NO OTA 2MB App / 2MB LittleFS partition scheme to accommodate the fonts and weather icon set. Select this in the Arduino IDE under Tools → Partition Scheme before flashing.
- Make your language selection first in the All_Settings.h file (see section below)
- Flash the firmware and upload the LittleFS data folder (fonts and icons)
- Power on the device — it will create a WiFi access point called WabbitWeather
- Connect to that access point with your phone or computer
- Select your home WiFi network and enter the password
- The device reboots and connects to your network
- Open http://wabbitweather.local in a browser (or http://xxx.xxx.xxx.xxx your routers IP)
- Click the map to set your location — timezone is detected automatically
- Hit Update & Save
- Done — the display updates immediately with your local weather
If you're new to Arduino, read down further for detailed installation steps
Open All_Settings.h and uncomment the language you want:
#define LANG_EN // English (default)
//#define LANG_FR // French
//#define LANG_DE // German
//#define LANG_ES // Spanish
//#define LANG_NL // Dutch
//#define LANG_PT // Portuguese
//#define LANG_TR // TurkishDownload the zip from GitHub and extract it. GitHub names the extracted folder WabbitWeather-master. Arduino requires the sketch folder name to exactly match the .ino filename, so you must rename it before opening the sketch.
Rename WabbitWeather-master → WabbitWeather, then open WabbitWeather/WabbitWeather.ino in the Arduino IDE.
If you skip this step the .cpp files won't compile and you'll see a wall of "undefined reference" linker errors.
In Tools → Board, select ESP32 Dev Module, then set:
| Setting | Value |
|---|---|
| Partition Scheme | No OTA (2MB APP/2MB SPIFFS) |
| CPU Frequency | 240MHz (WiFi/BT) |
| Flash Size | 4MB (32Mb) |
| Upload Speed | 115200 |
⚠️ Do not select the FATFS variant — WabbitWeather uses LittleFS and the icons and fonts stored on flash will not be found at runtime. Upload the data partition after uploading the sketch, with the correct port selected.
The weather icons and fonts live in the data folder and must be uploaded to the ESP32's flash separately — uploading the sketch alone is not enough. The method differs between IDE versions. If you've never uploaded LittleFS data before or get an error while trying to because the uploader is not installed keep reading...
Arduino IDE 1.x
Install the ESP32 LittleFS upload plugin:
- Download from: https://github.com/lorol/LITTLEFS_esp32fs-plugin/releases
- Place the
.jarfile in<Arduino sketchbook>/tools/ESP32LittleFS/tool/ - Restart the IDE
- Use Tools → ESP32 LittleFS Data Upload
Arduino IDE 2.x
Install the separate upload tool:
- Download from: https://github.com/earlephilhower/arduino-littlefs-upload/releases
- Place the
.vsixfile in the correct location per the instructions on that page - Restart the IDE
- On macOS, press [⌘] + [Shift] + [P], Windows: [Ctrl] + [Shift] + [P]
- Type in Upload and you'll see "Upload LittleFS to PICO/ESP8266/ESP32"
⚠️ The serial monitor must be closed before uploading the data partition.
- Removed search icon from map and placed two search options by TZ lines
- Adjusted number of locations found for easier selection
- Fixed phone display from auto resizing on search
- Search can be by city, address or country
- Dual location support — tap the weather icon area to toggle between TZ1 and TZ2
- Automatic timezone detection via timeapi.io — no hardcoding, no dropdowns
- Timezone offsets self-correct at 2am daily for both locations
- Map search box — type a city name to jump there instantly
- Correct local time shown for whichever location is active
- Correct dusk dimming for whichever location is active
- Forecast start today/tomorrow option (up to 8 days from current day)
- JChristensen Timezone library eliminated entirely
- Language selection moved to All_Settings.h
- Fixed daily forecast to show HIGH then LOW (matching worldwide convention)
- Three touch zones (clock / weather / forecast)
- 8-day forecast with tap-to-page between day sets
- Auto-return to main forecast after 15 seconds
- Forecast start day option (today or tomorrow)
- Adapted from Bodmer DarkSkyWeather to use Open-Meteo (no subscription)
- Nominatim location lookup (no subscription)
- 6hr rotating forecast (POP%, temperature, dew point)
- Temperature and precipitation threshold colours
- UV index display
- Auto display dimming at dusk/dawn
- Full web configuration interface
- Multilingual support (EN, FR, DE, ES, NL, PT, TR)
- Moon phase icons with southern hemisphere flip
- Original sketch by Daniel Eichhorn
- Adapted by Bodmer for TFT_eSPI and OpenWeather
- Extended by WabbitGuy for Open-Meteo, Nominatim, dual location, web config and more
Weather data: Open-Meteo — free, no API key required
Location lookup: Nominatim / OpenStreetMap — free, no API key required
Timezone detection: timeapi.io — free, no API key required
Map tiles: OpenStreetMap via Leaflet
WabbitWeather is open source under the MIT License