Skip to main content

Python package to talk to Brother QL label printers

Project description


Python package for the raster language protocol of the Brother QL series label printers


This is a fork of by Philipp Klaus to enable updates to the sparsely unmaintained upstream project. Check out to see what I forked it for.

Verified models

Verified devices

✓ means the device was verified by the original project

QL-500 (✓), QL-550 (✓), QL-560 (✓), QL-570 (✓), QL-580N QL-600 (✓), QL-650TD QL-700 (✓), QL-710W (✓), QL-720NW (✓) QL-800 (✓), QL-810W (✓), QL-820NWB (✓) QL-1050 (✓), QL-1060N (✓), QL-1100 (✓), QL-1100NWB, QL-1115NWB.

Verified labels

The available label names can be listed with brother_ql info labels:

 Name      Printable px   Description
 12         106           12mm endless
 29         306           29mm endless
 38         413           38mm endless
 50         554           50mm endless
 54         590           54mm endless
 62         696           62mm endless
 102       1164           102mm endless
 103       1200           103mm endless
 104       1200           104mm endless
 17x54      165 x  566    17mm x 54mm die-cut
 17x87      165 x  956    17mm x 87mm die-cut
 23x23      202 x  202    23mm x 23mm die-cut
 29x42      306 x  425    29mm x 42mm die-cut
 29x90      306 x  991    29mm x 90mm die-cut
 39x90      413 x  991    38mm x 90mm die-cut
 39x48      425 x  495    39mm x 48mm die-cut
 52x29      578 x  271    52mm x 29mm die-cut
 54x29      598 x  271    54mm x 29mm die-cut
 62x29      696 x  271    62mm x 29mm die-cut
 62x100     696 x 1109    62mm x 100mm die-cut
 102x51    1164 x  526    102mm x 51mm die-cut
 102x152   1164 x 1660    102mm x 153mm die-cut
 103x164   1200 x 1822    103mm x 164mm die-cut
 d12         94 x   94    12mm round die-cut
 d24        236 x  236    24mm round die-cut
 d58        618 x  618    58mm round die-cut


There are multiple backends for connecting to the printer available (✔: supported, ✘: not supported):

Backend Kind Linux Mac OS Windows
network (1) TCP
linux_kernel USB ✔ (2)
pyusb (3) USB ✔ (3.1) ✔ (3.2) ✔ (3.3)

Significant Changes:


Read the full old Readme here.

Project details

Download files

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

Source Distribution

brother_ql-inventree-1.0.tar.gz (40.3 kB view hashes)

Uploaded Source

Built Distribution

brother_ql_inventree-1.0-py3-none-any.whl (49.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page