Skip to main content

Python library to manipulate ESC/POS Printers

Project description

Continous Integration Code issues Code Health Code Coverage Documentation Status


Python ESC/POS is a library which lets the user have access to all those printers handled by ESC/POS commands, as defined by Epson, from a Python application.

The library tries to implement the functions provided by the ESC/POS-commandset and supports sending text, images, barcodes and qr-codes to the printer.

Text can be aligned/justified and fonts can be changed by size, type and weight.

Also, this module handles some hardware functionalities like cutting paper, control characters, printer reset and similar functions.


This library makes use of:

  • pyusb for USB-printers
  • Pillow for image printing
  • qrcode for the generation of QR-codes
  • pyserial for serial printers

Documentation and Usage

The basic usage is:

from escpos.printer import Usb

""" Seiko Epson Corp. Receipt Printer M129 Definitions (EPSON TM-T88IV) """
p = Usb(0x04b8,0x0202,0)
p.text("Hello World\n")

The full project-documentation is available on Read the Docs.


This project is open for any contribution! Please see CONTRIBUTING.rst for more information.

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
python_escpos-2.2.0-py2.py3-none-any.whl (29.1 kB) Copy SHA256 hash SHA256 Wheel 3.4
python-escpos-2.2.0.tar.gz (87.9 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page