Skip to main content


Project description

afthermal is a driver/library for the popular Adafruit (originally Cashino A2) thermal printer [1].

Partially, it is inspired by previous efforts:

afthermal try to be more pythonic and efficient than previous efforts, which have mostly been 1:1 ports from other languages. Additionally it is not focused on education but rather on being a reliable library for handling this kind of hardware.

Features include:

  • Comfortable handling of text formatting

  • Adapters to print images from PIL / Pillow as well as OpenCV

  • A fast Floyd-Steinberg implementation to dither OpenCV images.

  • Command-line utilities for calibrating the printer for optimum speed and quality, as well as other capabilities

  • Support for printing QR codes via PyQRCode without having to render them into images first


afthermal is installable from pip. It supports an extra feature named tools, installing it will include cli tools for calibrating the printer, printing test images or other tasks:

$ pip install 'afthermal[tools]'

It includes a C extension for Floyd-Steinberg dithering, since OpenCV does not ship with a dithering function. For this reason C-modules must be compileable when installing afthermal.

Full docs

The complete documentation is housed at

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

afthermal-0.3.1.tar.gz (44.2 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page