brother_ql 项目全面解读零驱动直连 Brother QL 标签机的 Python 终极打印方案【免费下载链接】brother_qlPython package for the raster language protocol of the Brother QL series label printers (QL-500, QL-550, QL-560, QL-570, QL-700, QL-710W, QL-720NW, QL-800, QL-810W, QL-820NWB, QL-1050, QL-1060N and more).项目地址: https://gitcode.com/gh_mirrors/br/brother_qlbrother_ql是一个开源的 Python 打印工具包让你无需任何打印机驱动就能直接控制 Brother QL 系列热敏标签打印机QL-500、QL-700、QL-710W、QL-800 系列、QL-1050 等。它完整实现了 Brother 的 raster 点阵打印语言把图片转换成打印机能直接执行的指令文件并通过 USB 或网络发送出去。无论你是想给 Raspberry Pi 配置标签打印还是需要像素级精度的条码标签这套方案都能快速搞定。一、为什么零驱动直连是终极方案很多程序打印标签时都会遇到页面大小、边距设置不对的麻烦而 brother_ql 的做法更彻底——它完全绕过了操作系统的打印系统和打印机驱动与标签机直接对话。这带来几个实际好处没有驱动也能打印Brother 官方没有提供 Linux ARM如树莓派的驱动但 brother_ql 照样能正常工作像素级精确控制打印条码等高精度内容时每个点都由你的代码决定跨平台、轻量一条 pip 命令即可安装依赖极少。相关背景说明可在项目说明文件 README.md 的 Why 章节中找到。二、支持的打印机型号与标签类型brother_ql 内置了 17 款 Brother QL 系列机型型号与差异是否支持压缩、双色打印、自动切纸等全部定义在 brother_ql/models.py 中类别型号经典机型QL-500、QL-550、QL-560、QL-570、QL-580N、QL-650TD家用/商用QL-700、QL-710W、QL-720NW双色系列QL-800、QL-810W、QL-820NWB可在 DK-22251 标签上打印黑红双色宽幅机型QL-1050、QL-1060N、QL-1100、QL-1110NWB、QL-1115NWB标签brother_ql/labels.py覆盖四种形态连续纸endless12 / 29 / 38 / 50 / 54 / 62 / 102 / 103 mm长度自定义模切标签die-cut如 17x54、29x90、62x100、103x164 mm 等预裁尺寸圆形模切标签roundd12 / d24 / d58 mmPTouch 连续标签PT-P750W、PT-P900W 机型。 想查看完整的标签清单和推荐像素尺寸运行brother_ql info labels即可。三、一键安装pip 命令行快速上手brother_ql 发布在 PyPI 上安装只需一条命令pip install --upgrade brother_ql加上--upgrade可以同时保证包和依赖都是最新版。如果你希望使用最新开发版源码git clone https://gitcode.com/gh_mirrors/br/brother_ql pip install --upgrade ./brother_ql⚠️ 小提示在部分系统上 pip 默认安装到~/.local/bin若提示找不到brother_ql命令请将该目录加入 PATH如export PATH${PATH}:~/.local/bin。依赖声明见 setup.pyclick、pillow、pyusb、packbits、attrs全部为常见轻量库。四、三种连接后端USB / 网络 / Linux 内核连接层代码位于 brother_ql/backends/通过设备标识符自动识别后端见 brother_ql/backends/init.py后端传输方式LinuxmacOSWindows设备标识示例networkTCP 网络✔✔✔tcp://192.168.1.21:9100pyusbUSB 用户态✔✔✔usb://0x04f9:0x2015/000M6Z40linux_kernel/dev/usb/lp0✔✘✘file:///dev/usb/lp0network跨平台首选适合 WiFi/以太网机型W/NW 后缀但不能读回打印机状态pyusb跨平台 USB 方案Linux/macOS 需安装 libusbWindows 需装 libusb-win32 并用 Filter Wizard 配置设备过滤器linux_kernelLinux 专用连接后自动出现/dev/usb/lp0普通用户打印前需检查该文件的属主权限。五、三条命令打印第一张标签 ️设置好环境变量后打印一张 62mm 连续纸标签只需一行export BROTHER_QL_PRINTERtcp://192.168.1.21 export BROTHER_QL_MODELQL-710W brother_ql print -l 62 my_image.pngCLI 完整入口在 brother_ql/cli.py支持 5 个子命令命令用途print将图片直接转成 raster 指令并打印discover自动查找已连接的标签机info列出支持的型号info models和标签info labelssend发送已有的 .bin 指令文件analyze反向解析 .bin 指令文件还原出 PNG 图片实现在 brother_ql/reader.py 全局选项也可用环境变量代替BROTHER_QL_MODEL、BROTHER_QL_PRINTER、BROTHER_QL_BACKEND、BROTHER_QL_LABEL脚本化使用时非常省事。六、高级选项速查表print命令常用参数一览转换核心逻辑在 brother_ql/conversion.py指令生成引擎在 brother_ql/raster.py参数作用-t, --threshold黑白阈值百分比默认 70-d, --dither抖动算法替代阈值灰度表现更好-c, --compress启用指令压缩传输体积明显变小-r, --rotate图片逆时针旋转 0/90/180/270 度auto自动判断--600dpi部分机型支持 600×300 dpi 高精度打印--redQL-8xx 系列 DK-22251 双色带必用选项--lq低质量模式打印更快--no-cut打印后不自动切纸最佳实践图片像素宽度与标签可打印像素一致效果最好模切标签必须使用精确像素尺寸可用info labels查询连续纸宽度不符时会自动缩放。七、避坑指南新手最容易踩的 4 个坑Editor Lite 模式未关闭若打印机处于 Editor Lite 模式USB 打印会失败。请长按机器按钮直到对应 LED 熄灭pyusb 找不到设备确认已安装 libusb 并正确配置了设备过滤器可先用brother_ql discover验证连接双色带忘记加--red在 QL-8xx 上使用黑/红/白标签带时即使不打红色也必须加此参数网络后端查不到错误network后端无法检测标签类型错误纸卷用完等状态遇到问题优先换 USB 后端排查。遇到问题时运行brother_ql info env可以输出完整环境信息方便提交 issue 时描述问题。八、项目结构与源码导读模块职责brother_ql/cli.py统一命令行入口click 框架brother_ql/models.py打印机型号库长度范围、压缩/双色/切纸能力brother_ql/labels.py标签规格库像素尺寸、边距、颜色支持brother_ql/raster.pyraster 点阵语言指令生成引擎brother_ql/conversion.py图片 → 黑白位图 → 指令文件的转换流水线brother_ql/reader.py指令文件反向解析还原图片与打印机状态brother_ql/backends/pyusb / network / linux_kernel 三种传输后端此外项目还保留了一套旧版独立命令行工具brother_ql_create、brother_ql_print、brother_ql_analyse等定义见 setup.py 的 entry_points目前已标记为弃用统一使用新的brother_ql单命令即可历史用法参考 LEGACY.md。九、总结brother_ql 用不到 20 个源码文件就实现了 Brother QL 标签打印机的完整零驱动打印链路pip install安装 → 环境变量指定机型 → 一条print命令出标签。对于树莓派、自动化产线、条码标签等场景它比官方驱动方案更简单、更精确、更可定制是 Python 生态里操作 Brother 热敏标签打印机的首选工具。【免费下载链接】brother_qlPython package for the raster language protocol of the Brother QL series label printers (QL-500, QL-550, QL-560, QL-570, QL-700, QL-710W, QL-720NW, QL-800, QL-810W, QL-820NWB, QL-1050, QL-1060N and more).项目地址: https://gitcode.com/gh_mirrors/br/brother_ql创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考