DM
dmachard/custom-epaper-station
A Bluetooth-controlled multi-screen e-paper dashboard with prometheus support metrics, powered by ESP32-C6.
Custom E-Paper Station
A connected information display based on an ESP32-C6 and a 4.2" E-Paper Screen.
๐ Features
- Multi-Screen Display:
- Events: Displays upcoming calendar events.
- Sensors: 16 configurable slots for displaying data from APIs (Prometheus, JSON).
- Connectivity:
- WiFi: For data fetching methods.
- Bluetooth LE (BLE): For easy configuration via a Web App.
- Web Configuration App
๐ ๏ธ Hardware
- Microcontroller: ESP32-C6 (RISC-V)
- Display: GoodDisplay GDEY042T81 (4.2" E-Ink) or compatible GxEPD2 supported screen.
๐ Project Structure
firmware/: PlatformIO project (C++ source code).web/: The Configuration Web App (HTML/JS/CSS).docs/: Additional documentation.enclosure/: STL files
๐ Getting Started
1. Firmware
- Open the
firmwarefolder in VS Code with the PlatformIO extension. - Connect your ESP32-C6.
- Click Upload.
2. Web Interface
- Open
web/index.htmlin a Chrome-based browser or your mobile - Click Connect to Device.
- Select your ESP32 from the list (named "ESP32_Config").
- Configure your WiFi and Sensors!
๐ง Configuration
The device exposes a generic sensor system. You can map any JSON API value to a display slot.
- Source Type:
Prometheus(raw text) orJSON. - JSON Path: Extract specific values using dot notation (e.g.,
feeds.field1). - Adjustments: Set divisors, decimals, and units.
On this page
Languages
C++52.9%JavaScript24.8%HTML12.6%CSS8.5%Makefile0.6%C0.5%
Latest Release
v0.1.0February 16, 2026MIT License
Created February 4, 2026
Updated February 16, 2026
