Python package for the raster language protocol of the Brother QL series label printers
This is a fork of https://github.com/pklaus/brother_ql by Philipp Klaus to enable faster updates. Check out https://github.com/inventree/inventree to see what I forked it for.
✓ 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-1110NWB, QL-1115NWB.
The available label names can be listed with brother_ql info labels:
Name Printable px Description
12 106 12mm endless
12+17 306 12mm endless
18 234 18mm endless
29 306 29mm endless
38 413 38mm endless
50 554 50mm endless
54 590 54mm endless
62 696 62mm endless
62red 696 62mm endless (black/red/white)
102 1164 102mm endless
103 1200 104mm 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
60x86 672 x 954 60mm x 87mm 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 104mm 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
pt12 - unknown - 12mm endless
pt18 - unknown - 18mm endless
pt24 - unknown - 24mm endless
pt36 - unknown - 36mm endless
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) |
Warning: when using one of the USB backends make sure the Editor Lite feature is turned off (if your model supports it), otherwise the USB Printer interface won't be detected.
v 1.3:
- Added detection of more media and commands to list and configure settings matmair#57
- Added new cli command for getting the status of printers matmair#53
v1.2:
- Remove support for Python 2 matmair#43 / matmair#45
- Added support for PT-E550W matmair#44
- Added label support for 12+17 matmair#42
v1.1:
-
Support for Pillow 10.x matmair#37 v1.0:
-
Renamed the package to
brother_ql-inventreeand added a release action matmair#16 -
Added printer support for QL-600 matmair#17 , PT-P950NW matmair#6 , QL-1100, L-1100NWB, QL-1115NWB matmair#18
-
Added label support for DK-1234 matmair#22 , 54x29 matmair#19 , DK22246 matmair#20, ...
Read the full old Readme here.