Python library to manipulate ESC/POS Printers
Project 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 library tries to implement the functions provided by the ESC/POS-command-set 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.
Since supported commands differ from printer to printer the software tries to automatically apply the right settings for the printer that you set. These settings are handled by escpos-printer-db which is also used in escpos-php.
Dependencies
This library makes use of:
pyusb for USB-printers
Pillow for image printing
qrcode for the generation of QR-codes
pyserial for serial printers
python-barcode for the generation of barcodes
Documentation and Usage
The basic usage is:
from escpos.printer import Usb
""" Seiko Epson Corp. Receipt Printer (EPSON TM-T88III) """
p = Usb(0x04b8, 0x0202, 0, profile="TM-T88III")
p.text("Hello World\n")
p.image("logo.gif")
p.barcode('4006381333931', 'EAN13', 64, 2, '', '')
p.cut()Another example based on the Network printer class:
from escpos.printer import Network
kitchen = Network("192.168.1.100") #Printer IP Address
kitchen.text("Hello World\n")
kitchen.barcode('4006381333931', 'EAN13', 64, 2, '', '')
kitchen.cut()Another example based on the Serial printer class:
from escpos.printer import Serial
""" 9600 Baud, 8N1, Flow Control Enabled """
p = Serial(devfile='/dev/tty.usbserial',
baudrate=9600,
bytesize=8,
parity='N',
stopbits=1,
timeout=1.00,
dsrdtr=True)
p.text("Hello World\n")
p.qr("You can readme from your smartphone")
p.cut()The full project-documentation is available on Read the Docs.
Contributing
This project is open for any contribution! Please see CONTRIBUTING.rst for more information.
Disclaimer
None of the vendors cited in this project agree or endorse any of the patterns or implementations. Its names are used only to maintain context.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file python-escpos-3.1.tar.gz.
File metadata
- Download URL: python-escpos-3.1.tar.gz
- Upload date:
- Size: 199.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 31240cdd43a6d3371c2c536f8dec02f31bf68ee967cd2edb255a94cf67295ac0 |
|
| MD5 | 58982df4d6837037cb7e995d01811127 |
|
| BLAKE2b-256 | b5e8dbcaca6c9db8d133e3a2fc36982f20bb0bdc9bdc9e04a540b231dd75b2d1 |
File details
Details for the file python_escpos-3.1-py3-none-any.whl.
File metadata
- Download URL: python_escpos-3.1-py3-none-any.whl
- Upload date:
- Size: 69.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d9aec8c50b106ca83aaf0781e2bd38a02c82ab206cb6d673241db5252438c73e |
|
| MD5 | 6243ed1bc28497d8407fa64d7967ce12 |
|
| BLAKE2b-256 | 885edef5f834b900d98c4c6477469b4e0cd1147d7158ddffcddac6904ec53f6e |
