No description
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-07-16 20:24:25 +02:00
assets Initial version 2026-07-16 20:24:25 +02:00
brother_ql_labels Initial version 2026-07-16 20:24:25 +02:00
.gitignore Initial version 2026-07-16 20:24:25 +02:00
LICENSE Initial version 2026-07-16 20:24:25 +02:00
pdm.lock Initial version 2026-07-16 20:24:25 +02:00
pyproject.toml Initial version 2026-07-16 20:24:25 +02:00
README.md Initial version 2026-07-16 20:24:25 +02:00

Brother QL Labels

Small label generator for Brother QL network printers.

Setup

Requires Python 3.14 and PDM.

pdm install

Usage

Start the GUI:

pdm run gui

Show CLI options:

pdm run cli --help

Generate a PNG:

pdm run cli --label 17x54 --main-text "Example" --output label.png

Print a label:

pdm run cli --label 17x54 --main-text "Example" --print

Printer configuration

Create:

~/.config/brother-ql-labels/config.toml

or use $XDG_CONFIG_HOME/brother-ql-labels/config.toml.

[printer]
model = "QL-820NWB"
address = "192.168.1.20"
port = 9100

Only network printers are supported.

License

Application code: MIT License.

Bundled Noto Sans Mono fonts: SIL Open Font License 1.1. See assets/fonts/OFL.txt.