Printer settings

The Printer tab points Fexl Lite at the thermal receipt printer attached to this device. One printer per device, configured here, used everywhere the app prints a receipt — POS post-checkout, the Last Sale reprint, the Invoices detail page, the cash drawer’s open-shift slip.

Updated 5 May 2026·For v2.2.0·5 min read

ⓘ

Desktop only

ESC/POS printing requires direct hardware access — the Tauri desktop app handles it via Rust. The web app falls back to PDF download and the system print dialog. If you need thermal printing, install the desktop app from Install on Windows or Install on macOS.

Printer detection

When the tab opens, the desktop polls the OS for connected printers and shows three buckets:

• USB Printers — auto-detected via the Tauri usb feature. Each entry shows the vendor:product ID and the manufacturer / product name reported by the device. Click a row to select it; the path becomes usb:VENDOR:PRODUCT (e.g. usb:04b8:0e15).
• Network Printer — a placeholder entry; click to expose an IP:PORT input for printers on the same LAN. Port 9100 is the de-facto standard for ESC/POS over network.
• OS Default Printer — a fallback that routes through the OS print stack (CUPS on macOS / Linux, the Windows default printer). Plain text only — no ESC/POS formatting, no cut command. Only useful when nothing else is wired up.

Pick a row, hit Save, and the path is stamped against this device — every print from this device goes there until you change it.

Setting up a USB printer

1

Plug in and power on

USB cable directly to the desktop. Most thermal printers don’t need vendor drivers — Fexl Lite talks raw ESC/POS over USB.

2

Pick the printer in Settings → Printer

The USB Printers list lights up with whatever’s connected. Tap your row. The path field updates to usb:VENDOR:PRODUCT. Save.

3

Hit Test Print

A short test receipt prints — store name, a few placeholder lines, a barcode. If the cut line fires at the bottom, you’re done.

✦

Printer not in the list

On macOS, give the Fexl Lite app Input Monitoring permission (System Settings → Privacy & Security). On Linux, add your user to the lp group and re-login. Windows usually just works. If still nothing, see ESC/POS printers for the full troubleshooting tree.

Setting up a network printer

For shared printers in a back-office or warehouse setup. Pin the printer’s IP statically in your router so the path doesn’t drift. Pick Network Printer, type 192.168.1.50:9100 (or whatever the printer reports), save, test-print.

Default template

A dropdown of the receipt templates from Invoice Templates. The chosen one is what POS prints by default after every checkout — the cashier doesn’t get a “which template?” prompt unless you configure one. Most shops pick Compact here even if their A4 active template is Modern; thermal paper is narrow.

Auto-cut

A toggle. On sends the cut command after every receipt; off holds the paper for tear-off. Set off if your model doesn’t have a cutter (some cheap printers ignore the cut command but still print fine), or you tear receipts by hand and don’t want the cutter to wear out.

Cash drawer kick

A toggle plus an optional kick code. When on, every cash sale fires a pulse out the printer’s RJ-12 cash-drawer port to pop the till. The kick code is a hexadecimal byte sequence (1B 70 00 32 FA is the most common); leave the field blank to use the ESC/POS default. Different drawer / printer pairings sometimes need a tweaked code — check your drawer’s manual.

!

Cash drawer won't open?

Three things to verify, in order: (1) the RJ-12 cable is plugged into the drawer port on the printer (not the LAN port — they’re the same shape); (2) the printer firmware has cash-drawer kick enabled in its self-test menu; (3) the kick code matches your model. If still nothing, drop the kick code field empty and let Fexl Lite use the default.

Test print

The single most useful button on the tab. Re-runs the same short receipt the post-checkout flow runs, with the current path, default template, auto-cut, and kick settings. Use it after every config change before going back to the till.

Per-device, not per-tenant

The printer path is stored against this device, not the tenant. A two-tablet shop with one printer per tablet has two different usb:... paths in the same tenant — neither overrides the other. Cloud sync deliberately ignores the printer field for that reason.

Related

ESC/POS

ESC/POS deep dive

Path patterns, code pages, character-set quirks, and the symptom-to-fix table for printing issues.

TEMPLATES

Receipt templates

The default template dropdown above feeds from the gallery here.

HELP

Printing troubleshooting

Blank receipts, garbled characters, missing cut command — symptom-to-fix.

TERMINAL

Payment terminal

The other Tauri-only hardware tab — Nebula card terminal config.