A browser-based image dithering tool for e-paper displays. Runs entirely client-side using the Canvas API — no server, no uploads. Download perfectly dithered PNG files, or send them directly to an OpenDisplay device over Bluetooth.

Try it live →

This app is an experiment to find the optimal dithering algorithm and settings for different e-paper displays. It is permanently work in progress, can change features at any moment, and is not meant to be relied on for production use. It's a sandbox for me to play around in.

• Dithering algorithms — to figure out what works best, we're trying classics like Floyd-Steinberg, Atkinson, Jarvis-Judice-Ninke, Stucki, Burkes and Sierra. But also less well-known or more recent algorithms like Riemersma (Hilbert-curve), Blue noise (void and cluster), Yliluoma II, Eschbach & Knox, and Dizzy
• Palette-accurate output — each palette carries both measured colors (how the panel actually looks) and ideal colors (what the device expects); dithering runs against calibrated, export uses ideal
• Calibration variants — choose from different color profiles per panel type: community estimations, datasheet typicals (GooDisplay GDEP133C02), and real colorimeter measurements (CR30, 5-sample CIELAB averages)
• Multiple display presets — Seeed reTerminal, TRMNL, Waveshare PhotoPainter, Pimoroni Inky Impression, Soldered Inkplate, Solum M3 ESL, Gicisky ESL, or custom dimensions and panels
• Image adjustments — tone mapping, saturation, exposure, clarity (midtone unsharp mask), dynamic range compression, per-channel RGB gains, and per-hue saturation bands
• Auto Expose — one-click histogram-based tone normalisation; derives exposure and contrast from OKLab luminance statistics as a starting point
• Color-tune — iterative optimizer that adjusts RGB channel gains to match the dithered output's chroma to the source
• Hue-tune — iterative optimizer that independently adjusts the saturation of each hue band (Red / Yellow / Green / Cyan / Blue / Magenta)
• Color space control — dither in RGB, CIELAB, OKLab, or OKLab chroma-aware; independently choose error diffusion space and nearest-color distance space
• Zoom / pan — click the preview canvas to zoom to 1:1 pixels and drag to pan the full image
• Export — downloads a PNG or BMP sized exactly to the display, using ideal palette colors; rotation is applied before export
• OpenDisplay upload — send the dithered image directly to an OpenDisplay device over Web Bluetooth. Requires Chrome or Edge. Preliminary support for Gicisky/Picksmart ESL also added (but only tested on 7.5" tag)

Read the blog for more information: https://style.oversubstance.net/2026/06/dithering-is-obsolete-except-when-it-isnt-creating-opendithering/

• EPDOptimize (Paperlesspaper): https://github.com/paperlesspaper/epdoptimize
• aitjcize: https://github.com/aitjcize/esp32-photoframe
• mattcarter11: https://github.com/mattcarter11/eink-dithering-tester
• Liam Appelbe: https://liamappelbe.medium.com/dizzy-dithering-2ae76dbceba1
• OpenDisplay: https://opendisplay.org/

This whole thing was entirely vibecoded with Claude Code. I have not even looked at a single line. If you don't trust AI-written code, you probably should not run this.

npm install
npm run dev      # dev server at http://localhost:5173
npm run build    # type-check + production build → dist/
npm run preview  # serve the dist/ build locally

Requires Node 20+.

The processing pipeline runs in order: resize → clarity → dynamic range compression → tone mapping → saturation + hue-sat bands → exposure → channel gains → dithering → palette swap (export only). See CLAUDE.md for full architecture documentation.