whatisgithub

What is dithr-beta?

redphx/dithr-beta — explained in plain English

Analysis updated 2026-05-18

3Audience · generalComplexity · 2/5Setup · easy

In one sentence

A beta all-in-one app for dithering images and sending them over NFC to various eink screen devices, with a future open source MIT release planned.

Mindmap

mindmap
  root((Dithr beta))
    What it does
      Image dithering
      NFC transfer
      Eink screens
    Tech stack
      Capacitor framework
    Use cases
      Prep images for eink
      Transfer via NFC
      Device testing
    Audience
      Eink hobbyists
      Early testers
    Status
      Beta no source
      Future MIT release

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Convert a photo into a dithered image suitable for an eink screen.

USE CASE 2

Transfer a dithered image to an eink device over NFC.

USE CASE 3

Test compatibility of an eink screen or phone case with a single unified app instead of separate device apps.

What is it built with?

Capacitor

How does it compare?

redphx/dithr-beta0marildo/imago0xvasic/lobby-radio-player
Stars333
LanguagePythonVisual Basic .NET
Setup difficultyeasyeasyeasy
Complexity2/52/51/5
Audiencegeneralgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Currently buggy beta software with no public source code, some devices and features are still incomplete.

No code is available yet, but the developer plans to release the full version under MIT, which allows free use, modification, and sharing.

So what is it?

Dithr is an app and website for turning ordinary images into dithered pictures and sending them to eink screens, the kind of low power displays used in e-readers and some smart badges. The idea is to replace a pile of separate apps, one for each brand of screen, with a single tool that works across devices. This particular repository holds beta versions of the app and does not include any source code. According to the README, the finished, full release is planned to be open source and shared under the MIT license, which allows free use, modification, and sharing. Right now the beta supports sending images over NFC to several specific devices, including Good Display and Waveshare screens, the Xteink Tong Card, and Reink four color phone cases. Basic image editing and dithering, the process of converting a photo into the limited colors an eink screen can show, are described as working, though the project is still buggy overall. One known issue is that after an error happens in the sync dialog, you currently have to close and reopen it to continue. The developer has tested the app on a handful of screens, including several Good Display panels in different sizes and color modes, the Xteink Tong Card, a Reink phone case, and an EzSign screen. Planned future work includes a better built in editor with support for adding text and layers, more dithering methods to choose from, a web based version, Bluetooth Low Energy support, and support for iOS, since the app is built with the Capacitor framework. The README invites anyone using the beta to report bugs or share suggestions through the project's Issues section.

Copy-paste prompts

Prompt 1
Explain what dithering means and why it matters for eink screens.
Prompt 2
List which eink devices this beta version of Dithr currently supports.
Prompt 3
Walk me through transferring an image to a Good Display screen using NFC with this app.
Prompt 4
Summarize the known bugs and planned features mentioned in this project's README.

Frequently asked questions

What is dithr-beta?

A beta all-in-one app for dithering images and sending them over NFC to various eink screen devices, with a future open source MIT release planned.

What license does dithr-beta use?

No code is available yet, but the developer plans to release the full version under MIT, which allows free use, modification, and sharing.

How hard is dithr-beta to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is dithr-beta for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.