thermal-label-cli

Unified CLI for thermal label printers. Auto-detects every installed driver — Brother QL, DYMO LabelWriter, DYMO LabelManager, and any future driver built against @thermal-label/contracts.

Install

# CLI plus the driver(s) for your printer:
npm install -g thermal-label-cli @thermal-label/brother-ql-node

Printer family	Driver package
Brother QL	@thermal-label/brother-ql-node
DYMO LabelWriter	@thermal-label/labelwriter-node
DYMO LabelManager	@thermal-label/labelmanager-node

Quick example

thermal-label list                       # detect connected printers
thermal-label status                     # readiness + media + errors
thermal-label print text "Hello World"   # quick text print
thermal-label print image logo.png       # PNG / JPEG print

Documentation

Full docs at https://thermal-label.github.io/cli/.

• Command + flag reference
• TCP / WebUSB usage
• thermal-label-cli vs burnmark-cli — when to use which

Philosophy

Diagnostic-first: prove cabling, USB permissions, TCP connectivity; smoke-test media detection and error reporting; script one-off prints in CI or systemd units. For templates, barcodes, CSV batches, and sheet PDFs, see burnmark-cli — same drivers, production-oriented workflow.

Compatibility

Runtime	Node ≥ 24
Drivers	Auto-detects any installed @thermal-label/*-node driver with a discovery export
License	MIT

Contributing

See CONTRIBUTING/ on the org .github repo.