Skip to main content


Project description


afthermal is currently in alpha status. This is a snapshot release of the development branch. While it is used productively, some features may be unfinished or undocumented.

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
[1]Specification is available at


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.

Files for afthermal, version 0.3.1
Filename, size File type Python version Upload date Hashes
Filename, size afthermal-0.3.1.tar.gz (44.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page