Skip to content
Taprel
Docs menu Printers

Printers

Set up each printer in the app, pick one from your code, and what Taprel prints on.

1Set up each printer in the app

On the app’s Printers page, each printer has:

  • Type: Receipt, Label or Regular. The app guesses it from the name.
  • Printer language: ESC/POS, TSPL, ZPL or driver. Find it prints a small test in each and asks which one came out right.
  • Paper width for a receipt printer, or Label size for a label printer, from the box or the roll.
  • Resolution: 203 dpi by default, or 300 dpi.
  • Main printer of this type: the one to use when several have the same type.

2Pick one from your code

On its own, a print goes to the printer of the document’s type: a receipt to the receipt printer, a label to the label printer. So your code needs no printer names. To pick another type:

await printer.printDocument(doc, { printerKind: "label" });
  • With one printer of that type, it uses that one.
  • With several, it uses the one marked as main.
  • With several and none marked, you get PRINTER_NOT_CHOSEN.

Or pass an exact name, like { printer: "Front desk receipt" }. In React and Vue, print from usePrint() takes the same options.

To let the customer choose, list the printers with listPrinters(), or usePrinters() in React and Vue. Their fields are on API.

3Check its status

Each printer in the list has a status: ready, offline, paused, paperJam, paperOut, doorOpen, noToner or error. It’s what Windows reports, and many low-cost printers never report paper problems.

What Taprel prints on

  • Receipt printers that speak ESC/POS, the language almost every receipt printer uses, on 58 or 80 mm rolls.
  • Label printers that speak TSPL or ZPL.
  • Any printer with a Windows driver, through the driver route, which draws the document as a picture. It’s the safe choice for a printer whose language you don’t know. Cutting and the cash drawer don’t work this way, and give a warning instead: CUT_NOT_AVAILABLE or DRAWER_NOT_AVAILABLE.

The app’s test print shows in a few seconds whether a printer works, so try yours before you rely on it.

A printer that saves to a file, like Microsoft Print to PDF, asks where to save each time, so it can’t print silently. listPrinters() gives it canPrintSilently: false.

The app runs on Windows for now, and pages print from it in Chrome and Brave.