Setting up your printer (Admin → Printers & Peripherals)

Admin → Printers & Peripherals is where you register the thermal printers your outlet actually prints to -- separate from the browser's own print dialog covered in Printing your bills. This is the settings screen for network-connected AND cable (USB) printers Biller can print to directly (the latter via the Biller Print Agent), plus Bluetooth printers, which now print automatically too when you turn on print bridge mode (see below) -- no separate mobile app needed.

Adding a printer

1. Go to Admin → Printers & Peripherals and tap Add Printer.
2. Give it a name you'll recognize (e.g. "Front Counter" or "Kitchen").
3. If you've already set up the Biller Print Agent, printers it finds on your network appear in the detected printers list -- tap one to add it with no IP address, port, or device path to type in at all. Nothing detected yet? Tap Set up the print agent to get one running (see Printers & printing setup).
4. No agent, or need to enter a printer's details by hand? Open Advanced setup and fill it in yourself:
   • Connection type -- Network (Wi-Fi/Ethernet), USB (cabled to the machine running the Print Agent), or Bluetooth (paired to a handheld thermal printer -- prints automatically once you turn on print bridge mode on the phone next to it; see below).
   • For a network printer, its Host / IP address and Port (leave port at the default, 9100, unless your printer's manual says otherwise).
   • For a USB printer, its Device / Queue Name instead: on Linux, the device path (e.g. /dev/usb/lp0); on macOS, the CUPS raw-queue name (find it with lpstat -p).
5. Choose the printer's role: Receipt, Kitchen, or Both.
6. Choose the paper width your printer's roll takes -- 58mm or 80mm -- so receipts lay out correctly.
7. Tap Add.

Editing a printer that already has a network/USB address opens straight to Advanced setup, expanded, so your existing details aren't hidden behind the collapse.

Checking a printer is reachable

Each network printer in the list shows a status badge -- online, offline, or unknown -- with a refresh button next to it. Tap refresh any time to re-check that printer right now, rather than waiting for it to update on its own.

Test-printing

Tap Test Print on a network or USB printer to send a short test page straight from this screen -- a quick way to confirm the connection details (IP/port, or device/queue name) are correct before you rely on it for real bills. A USB printer's test print is relayed through the connected Biller Print Agent, the same path a real receipt/KOT takes.

Bluetooth printers show "Test Print" disabled, with a note that says "Requires the Biller mobile app — not available in the browser". A browser can't talk to a Bluetooth device directly, so test-printing to one only works from the Biller mobile app itself.

Enabling/disabling a printer

Use the toggle on each row to enable or disable a printer without deleting it -- handy if a printer is temporarily unplugged or being serviced.

Print bridge mode (use a phone as your printer)

If your outlet only has a phone and a Bluetooth thermal printer -- no computer, no separate print agent -- print bridge mode turns that phone into an automatic printer for receipts and kitchen tickets.

1. On the phone that sits next to your Bluetooth printer, open Biller in Chrome (or your usual Android browser) and sign in.
2. Go to Admin → Printers & Peripherals and find the Print bridge mode section.
3. Turn on Use this device as the printer, then confirm. This takes over from any other print agent already connected (a desktop computer running the printer companion, or another phone) -- an outlet uses one at a time.
4. Once the badge shows connected, receipts and kitchen tickets print automatically to your Bluetooth printer as bills come in -- no tapping needed for each one.

Keep the tab open. Bridge mode only works while Biller is open on that phone's screen -- it stops printing the moment you close the app or lock the phone. Leave the phone plugged in and the screen unlocked during service.

Turning the toggle off (or opening Biller on a different device) disconnects the bridge; turn it back on whenever you're ready to use that phone as the printer again.

Guided tour

The first time you open this page, a short guided tour walks through setting up the print agent, adding a detected printer, the Advanced manual fallback, and test print. It only shows itself once; if you want to see it again, open the "..." menu and pick Take a Tour.

What's different from the "Printing your bills" article

• This screen is the outlet-wide registry of printers Biller knows about (network and USB printers it can print to directly, plus Bluetooth printers that print automatically once print bridge mode is on).
• Printing your bills covers the bill-by-bill printing flow itself -- the paper-width toggle and Print button on a bill's print page, and the RawBT companion-app path for phone-connected thermal printers today.