Skip to content
ESP32 Wifi e-ink clock, including hardware
C C++ Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin add build info Jun 5, 2019
eagle doc update Mar 2, 2019
include initial commit Feb 10, 2019
lib initial commit Feb 10, 2019
src added ping command Sep 18, 2019
test initial commit Feb 10, 2019
weather-icons @ 58cb6a2 a little bit of OpenWeatherMap API support May 8, 2019
.gitignore added ping command Sep 18, 2019
.gitmodules a little bit of OpenWeatherMap API support May 8, 2019
.travis.yml missing files Feb 10, 2019
LICENSE Initial commit Feb 19, 2019 a little bit of OpenWeatherMap API support May 8, 2019
platformio.ini added ping command Sep 18, 2019

e-ink wifi clock

This is a work in progress. I'm still testing and updating the hardware, and the software is incomplete. Build at your own risk.

Use a Waveshare epaper (e-ink) display as a digital wifi clock. The clock synchronizes its time with NTP and can show local weather using OpenWeatherMap.

The clock also supports an optional environmental sensor module, which allows it to report the temperature, humidity and air pressure in the space it's in.

It also supports an optional DS3231 I2C real time clock with battery backup module. This allows it to know the time immediately upon booting, even without NTP, and to keep time more accurately than just the ESP32 is capable of.

FInally, it also supports an optional ambient light sensor. This allows the clock to power down the e-ink module in the dark (when it is unreadable), which should extend the lifespan of the module.


Eagle schematics and board are in the eagle directory.

The hardware is still in testing; I cannot make any promises about its suitability for any use or its reliability.

Prices are obviously from the time I made this list. Links to parts are meant to show parts that have identical pinouts to the ones I used in the PC board layout. The specific items may become unavailable over time or the listings might even change to other parts with incompatible pinouts, so please be careful to make sure you get parts with the correct pinouts if you want to use the PC board - this is meant to be a guide to the parts and not a specific shopping list.

Part AliExpress Amazon Notes
Waveshare 4.2" epaper module $28.79 $38.99
Wemos LOLIN32 ESP32 $5.50 $9.99 + $4.99
BME280 breakout $2.50 $11.20 optional lets you read the temperature, hunmidity and pressure where the clock is
DS3231 RTC breakout $1.04 $6.99 optional keeps more accurate time, works without NTP or wifi
photoresistor optional lets the clock power off display in the dark
$37.83 $72.16

Obviously AliExpress is an economical choice if you can wait a month or more for your parts to arrive.

The printed circuit board uses breakout boards and is easy to assemble. The current version is at


The e-ink clock software is built using the Arduino SDK. It builds under PlatformIO but with a little rearranging you could also build it with the Arduino IDE.

The application uses the GxEPD library to drive the Waveshare display. GxEPD is a subclass of Adafruit_GFX, so you can use its API to talk to the display. It also supports fast partial update on some Waveshare displays, which lets you write to the display much faster than a full screen write, without distracting flashing.


  • turn an image file into a C language bitmap - image2cpp
  • use fontconvert from Adafruit GFX Library to convert fonts to Adafruit GFX format
You can’t perform that action at this time.