ESP32 ePaper
A full-featured ePaper display library for ESP32 with graphics, fonts, images, and a demo application.
What is ESP32 ePaper?
ESP32_ePaper_example is an open-source library and demo for controlling ePaper (e-ink) displays using ESP32 microcontrollers. It solves the problem of creating rich graphical interfaces on low-power ePaper screens by providing a comprehensive set of drawing functions, font support, and image display capabilities. The library is optimized for performance with ESP32's SPI hardware, enabling fast updates and flexible visual output.
Embedded developers and hobbyists building IoT devices, smart displays, or low-power information panels with ESP32 and ePaper modules. It's particularly useful for those needing advanced graphics beyond basic text output.
Developers choose this library for its extensive feature set, including grayscale support, image rendering, and font flexibility, combined with high-speed SPI optimizations. The included demo application accelerates development by providing a ready-to-use example with WiFi and NTP integration.
Overview
Full featured ePaper library for ESP32 with demo application
Use Cases
Best For
- Building ESP32-based ePaper displays for weather stations or environmental monitors
- Creating low-power information panels for IoT dashboards
- Developing ePaper badges or name tags with custom graphics and fonts
- Prototyping ePaper interfaces for smart home devices
- Educational projects exploring embedded graphics and display drivers
- Displaying dynamic images and text on ePaper screens with ESP32
Not Ideal For
- Projects using ePaper displays with controllers other than GDEH029A1 or SSD1608, as support for others is pending
- Developers embedded in the Arduino ecosystem who prefer simpler, platform-agnostic libraries over ESP-IDF
- Applications requiring native grayscale JPEG support or progressive JPEG decoding, which are not supported
- Teams needing plug-and-play components without manual configuration of pins and SPIFFS images
Pros & Cons
Pros
Supports a wide range of primitives including polygons, arcs, and ellipses with fill options, enabling complex UI designs beyond basic shapes.
Includes embedded fonts, external font file support, and a vector 7-segment font, with text rotation and transparency features for dynamic displays.
Uses combined DMA and direct SPI transfers for speeds up to 20 MHz, ensuring fast display updates as highlighted in the README.
Allows dynamic selection between 4-bit grayscale and 1-bit black/white modes, providing flexibility for different visual needs without recompilation.
Cons
Currently only supports GDEH029A1/SSD1608-based modules, with other controllers 'to be added later,' restricting use with many popular ePaper displays.
Requires ESP-IDF environment, manual pin changes in EPDspi.h, and SPIFFS image preparation, which can be error-prone for beginners or rapid prototyping.
JPG decoding is limited to baseline format without progressive or lossless support, and native grayscale images are not handled, reducing flexibility for image sources.
Frequently Asked Questions
Related Projects
Wasm3🚀 A fast WebAssembly interpreter and the most universal WASM runtime
IRremoteESP8266Infrared remote library for ESP8266/ESP32: send and receive infrared signals with multiple protocols. Based on: https://github.com/shirriff/Arduino-IRremote/
ESPAudioArduino library to play MOD, WAV, FLAC, MIDI, RTTTL, OGG/Opus, MP3, and AAC files on I2S DACs or with a software emulated delta-sigma DAC on the ESP8266 and ESP32 and Pico
TinyGSMA small Arduino library for GSM modules, that just works
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.