https://github.com/rzeldent/esp32-openweather-ttgo

openweathermap.org interface for the ESP32 TTGO-Display
https://github.com/rzeldent/esp32-openweather-ttgo

esp32 esp32-arduino humidity openweathermap platformio stand-alone temperature ttgo ttgo-tdisplay weather weather-information

Last synced: 2 months ago
JSON representation

openweathermap.org interface for the ESP32 TTGO-Display

• Host: GitHub
• URL: https://github.com/rzeldent/esp32-openweather-ttgo
• Owner: rzeldent
• Created: 2019-12-10T20:54:32.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2023-12-21T08:40:02.000Z (over 1 year ago)
• Last Synced: 2025-03-25T23:34:49.931Z (3 months ago)
• Topics: esp32, esp32-arduino, humidity, openweathermap, platformio, stand-alone, temperature, ttgo, ttgo-tdisplay, weather, weather-information
• Language: C++
• Homepage:
• Size: 5.12 MB
• Stars: 13
• Watchers: 4
• Forks: 7
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# ESP32 openweather TTGO

[![Platform IO CI](https://github.com/rzeldent/esp32-openweather-ttgo/actions/workflows/main.yml/badge.svg)](https://github.com/rzeldent/esp32-openweather-ttgo/actions/workflows/main.yml)

openweathermap.org interface for the [TTGO-T-Display](https://github.com/Xinyuan-LilyGO/TTGO-T-Display/blob/master/TTGO-T-Display.ino) ESP32 Module

## Hardware

No additional hardware is required.

## Installation

Create an account at [www.openweathermap.org](www.openweathermap.org) to obtain an API key to query for the weather at your location.

I use Visual Studio Code and PlatformIO to edit and upload the sketches.

Install these, open the project folder and upload to the esp32-ttgo module using the USB-C connector.

Current state: ![TTGO Display](assets/hardware.png)

## Configuration

Make a connection to the access point "OpenWeather". The first time you can connect without a wifi password.

Here, in the menu, update the settings:

- Open Weather API key. The key obtained from openweather (see above)

- Location. A name of the location. This should be supported as a location by OpenWeather.

- TimeZone. The timezone to display the correct (local) time and DST.

- Use metric units. The choice to use Imperial or Metric settings for the temperature etc...

To reset the configuration press the top button while restarting.

There is also an option to use an alternative weather icon pack. This can be changed by the batch job to generate the icons.

## Status

The status is visible when connecting to the device using a web browser.

This page shows the status of the device, network and settings.

![Status](assets/status.png)

## Current state

At the moment the basic functionality is working:

- Time is updated, with timezones

- API is queried and temperature, humidity, pressure, weather description and icons are shown.

- Web browser configuration and status screen

However, there are still two buttons left on the TTGO-T-Display so room for improvement like:

- Humidity and temperature icons have some dithering pixels. New images?

- Provide historical information about temperature / humidity / pressure and graph it.

- Provide a weather forecast?

## Collaboration

New features / pull requests are welcome.

Please make a branch and, after checking it might be put into the main branch!

## Thanks

Used icons from: [https://www.dovora.com/resources/weather-icons/](https://www.dovora.com/resources/weather-icons/)

- Modern Weather Icon Pack

- Crystal Weather Icon Pack