Skip to main content
ESCPOS
======

Python library to manipulate ESC/POS Printers.

------------------------------------------------------------------
1. Dependencies

In order to start getting access to your printer, you must ensure
you have previously installed the following python modules:

* pyusb (python-usb)
* PIL (Python Image Library)

------------------------------------------------------------------
2. Description

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 standard usage is send raw text to the printer, but in also
helps the user to enhance the experience with those printers by
facilitating the bar code printing in many different standards,
as well as manipulating images so they can be printed as brand
logo or any other usage images migh have.

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

Also, this module handles some hardware functionalities like, cut
paper, carrier return, printer reset and others concerned to the
carriage alignment.

------------------------------------------------------------------
3. Define your printer

Before start create your Python ESC/POS printer instance, you must
see at your system for the printer parameters. This is done with
the 'lsusb' command.

First run the command to look for the "Vendor ID" and "Product ID",
then write down the values, these values are displayed just before
the name of the device with the following format:

xxxx:xxxx

Example:
Bus 002 Device 001: ID 1a2b:1a2b Device name

Write down the the values in question, then issue the following
command so you can get the "Interface" number and "End Point"

lsusb -vvv -d xxxx:xxxx | grep iInterface
lsusb -vvv -d xxxx:xxxx | grep bEndpointAddress | grep OUT

The first command will yields the "Interface" number that must
be handy to have and the second yields the "Output Endpoint"
address.

By default the "Interface" number is "0" and the "Output Endpoint"
address is "0x82", if you have other values then you can define
with your instance.

------------------------------------------------------------------
4. Define your instance

The following example shows how to initialize the Epson TM-TI88IV
*** NOTE: Always finish the sequence with Epson.cut() otherwise
you will endup with weird chars being printed.

from escpos import *

""" Seiko Epson Corp. Receipt Printer M129 Definitions (EPSON TM-T88IV) """
Epson = escpos.Escpos(0x04b8,0x0202,0)
Epson.text("Hello World")
Epson.image("logo.gif")
Epson.barcode
Epson.barcode('1324354657687','EAN13',64,2,'','')
Epson.cut()

------------------------------------------------------------------
5. Links

Please visit project homepage at:
http://repo.bashlinux.com/projects/escpos.html

Manuel F Martinez <manpaz@bashlinux.com>

Metadata

Release files for python-escpos 1.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-escpos 1.0.3
File Size Uploaded Provenance Actions
python-escpos-1.0.3.tar.gz 7.4 kB Without provenance Details for python-escpos-1.0.3.tar.gz

Release files / python-escpos-1.0.3.tar.gz

Download URL python-escpos-1.0.3.tar.gz
Size 7.4 kB
Tags Source
SHA-256 checksum
How to use checksums
155f0185ceff0e8f7dcf2af966868281702da3b2227f00613a03b88a347b02f6
BLAKE2b-256 checksum
How to use checksums
554ca330138fcf09b2d9194c23b02804778be83b44851b9c785b59756b23e913
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for python-escpos 1.0.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.3 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page