Label printing

Label printing is dedicated to a single job — printing a small sticker with a QR code, the repair ID, the customer, the device, and the issue, so you can stick it on the device at intake and find that device again at any moment by scanning the QR. It is separate from 80mm thermal printing.

Label printers

The label printer is the small-format sticker printer used for repair intake labels and device tags. It should be configured independently from the thermal receipt printer.

Choosing a label protocol

RepairNode supports four protocols, all over Wi-Fi TCP on port 9100:

• ESC/POS — generic thermal label printers. 60mm continuous label.
• TSPL — TSC and compatible. 60mm continuous.
• ZPL — Zebra and compatible. 60mm continuous.
• Brother QL — Brother QL-series raster protocol. 62mm continuous (the Brother roll size).

Set up the label printer

1. 1
   Open Settings → Printing → Label Printer

   Enable the toggle.
2. 2
   Pick the protocol

   Match the printer brand. When in doubt, ESC/POS is the broadest fit; Brother QL is correct only for Brother QL-series printers.
3. 3
   Pick the media preset

   The protocol-aware default is correct for almost everyone — 60mm continuous for ESC/POS / TSPL / ZPL, 62mm continuous for Brother QL. Do not force Brother QL onto the 60mm preset.
4. 4
   Enter printer name, IP, and port

   Port 9100 for all four protocols.
5. 5
   Tap Test Connection and Print Preview

   Verify the layout looks right. Then print a real repair label from any repair detail screen → action sheet → Print Label.

Languages and Unicode

Before sending anything to a text-mode label printer, RepairNode checks whether the actual content (your shop name, customer name, device, issue, terms, etc.) contains characters the printer can render. If it cannot:

• Text-mode label protocols (ESC/POS, TSPL, ZPL) refuse and surface the dialog.
• Brother QL never blocks because it rasterizes.

This avoids the classic problem of a label full of ? characters where the customer name should be.