Inky Renderer is a hybrid hardware-and-cloud project that combines ESP32 firmware with a Cloudflare Workers rendering service for Inkplate e-paper displays. It is built for Inkplate 10 and Inkplate 6COLOR, turning those devices into configurable dashboards for news, weather, artwork, feeds, calendars, and now-playing screens.

Key Features

  • Hybrid render pipeline: The worker returns compact JSON or CBOR metadata, and the firmware follows that metadata to fetch the final image or render endpoint.
  • Provider-rich content system: The project supports weather, NYTimes, Hacker News, RSS/Atom feeds, Spotify, Google Calendar, NASA APOD, Unsplash, Pixabay, Pexels, Wallhaven, xkcd, RAWG, and custom media gallery sources.
  • Display-aware output: Render paths are tuned for the strengths and limitations of both monochrome and 6-color Inkplate hardware.
  • Device management portal: WiFi provisioning, OTA firmware updates, filesystem uploads, and config updates are all handled through the on-device captive portal.
  • CBOR-first firmware flow: The current architecture favors compact metadata transport, helping reduce payload size and simplify device-side parsing.
  • Flexible wake behavior: Devices can run scheduled refreshes, button-triggered renders, provider-specific wake mappings, and quiet-hour sleep windows.

How It Works

  1. The device wakes on schedule or from a button press and calls the worker at /api/v1/content/....
  2. The worker selects a provider, builds display metadata, and returns it as JSON or CBOR.
  3. The firmware uses that metadata to either fetch a final render or resolve an image transformer path.
  4. The resulting JPEG is drawn to the Inkplate display, and the device returns to its low-power cycle.

Why This Project Matters

Most e-paper projects stop at a single-purpose firmware image. Inky Renderer treats the display like a programmable client in a larger rendering system. That makes it much easier to mix remote APIs, browser-based template rendering, image transformation, and hardware-specific display rules without hard-coding every layout into firmware.

The result is a practical full-stack setup for low-power information displays: Cloudflare handles orchestration and rendering, while the device stays focused on scheduling, connectivity, power management, and drawing the final frame.

Stack

  • Cloudflare Workers + Hono for API routing and remote render orchestration
  • Sharp + browser rendering for template and image processing
  • PlatformIO + C++ firmware for Inkplate device behavior, updates, and display control

If you want an e-paper project that goes beyond a single static dashboard and into reusable content infrastructure, Inky Renderer is a solid foundation.