Network-accessible printing for USB TSPL thermal label printers (library + REST API + web UI).
Project description
🏷️ LabelJetty
Turn a cheap, USB-only TSPL thermal label printer into a smart, network-accessible label printer - drive it from your phone, desktop, or another machine over your LAN. It talks to the printer directly over USB (no CUPS, no vendor driver) and gives you a mobile-first web UI, a REST API, and a Python library for printing PNGs, PDFs, text, markdown, barcodes and QR codes. Optional, self-contained Homebox integration is built in.
Install
pip install labeljetty
# or, with uv:
uv tool install labeljetty
This gives you three commands:
labeljetty- runs the service (REST API + web UI + background print worker)labeljetty-testbench- drives the printer library directly (real device or dry-run)labeljetty-hash-password- generates a password hash for a login user
You need Python 3.11+, libusb, and a USB TSPL printer. Set at least PRINTER_USB
(e.g. PRINTER_USB=vid:2d37:pid:62de, found via lsusb) in a .env or the environment, then
run labeljetty and open http://localhost:8888/.
Prefer Docker? The image is
motey/labeljetty.
Heads-up
- No authentication by default - fine on a trusted home LAN, but turn on
AUTH_MODE=protectedbefore exposing it to an untrusted network. - Reference hardware is a Vretti 420B (Poskey-class TSPL, ~203 dpi). It should work with any USB TSPL printer; feedback/PRs for other models are welcome.
More information
Full docs, the configuration reference, authentication, the REST API, printer/udev setup, and Homebox integration live on GitHub: https://github.com/motey/LabelJetty
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file labeljetty-0.1.0b1.tar.gz.
File metadata
- Download URL: labeljetty-0.1.0b1.tar.gz
- Upload date:
- Size: 293.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7b177b855f0324c2dea5b3b0e68b4876b5c4acbe610db6cf6eb3cabee6447e43
|
|
| MD5 |
d01bcf5a387b3cd1159238af3d3bc797
|
|
| BLAKE2b-256 |
396940b76dd3759491bf37d7cd2b12480d33e19642248f244a40a3f227f5904d
|
File details
Details for the file labeljetty-0.1.0b1-py3-none-any.whl.
File metadata
- Download URL: labeljetty-0.1.0b1-py3-none-any.whl
- Upload date:
- Size: 83.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bc6546840605b7fe9c13b4dba941854a98bdba4f8bf539bcd6230c6ccb6fbc5e
|
|
| MD5 |
5e3bb5f04822c8ab20efa0dec257b59a
|
|
| BLAKE2b-256 |
07992003ff2afef7aee866b1b20f857de3187c4e15063cd11de287a08dbfbae2
|
