# python-escpos/python-escpos

Python library to manipulate ESC/POS printers

Repository: https://github.com/python-escpos/python-escpos
Canonical: https://ross.abutalabs.com/products/python-escpos
Homepage: https://python-escpos.readthedocs.io
Language: Python
License: MIT
License Family: permissive
Topics: python, escpos, python-escpos, printer, pos-printers, pos-printer-driver, hacktoberfest
Last push: 2026-08-24T10:13:07+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 8, longevity 100
- inputs: {"age_days": 4188, "days_push": 9, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1316, forks 316 (observed 2026-08-28T04:04:20.842538+00:00)

## What it is
A Python library for controlling ESC/POS receipt printers as defined by Epson, supporting text, images, barcodes, and QR codes over USB, serial, and network connections. It uses printer capability profiles to automatically apply correct settings per device.

## Use cases
- print receipts from a Python application
- send barcodes and QR codes to a thermal printer
- control a USB ESC/POS printer
- print to a network receipt printer
- cut paper and reset a POS printer programmatically
- print images on a receipt printer

## When to choose
- you need to drive Epson-compatible ESC/POS receipt printers from Python
- you want USB, serial, or network printer support in one library
- you need barcode, QR code, and image printing on receipt printers

## When to avoid
- your printer does not support the ESC/POS command set
- you need high-level POS business logic rather than raw printer control
- you are working in a non-Python stack

## Facets
- artifact type: library
- maturity: active
- function: sdk, image-processing
- domain: developer-tools, hardware
- platform: python, windows, cross-platform
- tags: escpos, receipt-printer, thermal-printer, barcode, qr-code, point-of-sale, usb, serial, network-printing, hardware, automation, linux, macos

## Member repositories
- python-escpos/python-escpos (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:20.842538+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:48:30.600179+00:00, confidence not recorded.
  - readme: https://github.com/python-escpos/python-escpos (fetched 2026-08-28T04:04:20.842538+00:00, sha 1b0694a768c6)
  - registry_pypi: https://pypi.org/pypi/python-escpos/json (fetched 2026-08-29T12:07:33.373734+00:00, sha 7c35a06f4aab)
- Data as of 2026-08-30T08:39:29.467469+00:00.