MACOS FAMILY DASHBOARD / ESP32 APPLICATION
E-paper Maclink
A native macOS family dashboard for e-paper: Apple Calendar, Reminders, and Home Assistant sensors.
About this project
About this project
The family agenda, rendered on a Seeed XIAO ESP32-C3 with a 7.5-inch monochrome 800×480 panel, but almost none of the work happens on the display. A native SwiftUI Mac app pulls Apple Calendar and Reminders through EventKit plus optional Home Assistant sensors, composes the page with TRMNL pixel fonts, and uploads a PNG to a FastAPI server that keeps the last image in SQLite; the display wakes and fetches only when the frame changed. Two columns hold as many complete days as fit, with a lookahead of up to 31 days, and the footer takes up to four HA sensor readings with small Markdown. Each display gets its own check interval and daily update window. The catch is stated plainly: new content and date changes need the Mac awake and the app running. macOS 14 or later and a Swift 6 toolchain are required, and the firmware is GPLv3 because it builds on OpenDisplay.
From the README
From the README
- Build
- A Mac running macOS 14 or later, with a Swift 6 toolchain to build the app.
- Dependency
- Docker Compose on a machine reachable by both the Mac and display.
- Limit
- New content and date changes require the Mac app to run while the Mac is awake.
- Feature
- a configurable lookahead of up to 31 days
Hardware
Native board: Seeed XIAO ESP32C3
Boards: ESP32
Supported hardware: ESP32. Confirm the exact board revision and pin map in the upstream repository.
What the source supports
Upstream evidence: Reviewed from public README media at commit 72c012caca47 under MIT. Firmware was not executed.
Media credit & rights
Upstream project media · rights remain with its owner · Credit: kmplngj
Screenshots decoded from the upstream README at a pinned commit. Repository code and firmware were not executed; the license texts are included in the preview package.
View original source ↗ Copyright & removal · Reviewed
More projects on these boards
Athena Desk Orb Balboa GS100 With VL260 Topside Birthday Countdown Clock Clock Codex Meter Dayclock
See what an ESP32 project looks like, and whether it runs on your board.
FILTERS
Browse by form factor. Check the exact board, chip and peripherals before installing.
Try a project
Newest listings
Give your project a little spotlight.
Repository links do not imply author endorsement or verified hardware compatibility. Check the upstream safety guidance before powering or flashing a build.