Printers

The Printers module is where you see everything ProxyBox has found on your network and USB ports. Network scanning is on by default, so when you first boot your device, it automatically scans for printers — network printers advertising via mDNS/Bonjour and anything plugged in via USB show up here without any configuration.

• Scan for Printers — refreshes the list of available printers. When network scanning is on, it searches the network and checks USB connections. When network scanning is off, it refreshes USB-connected printers but does not search the network.
• Add Network Printer — manually add a printer by IP address and port. This is for printers that don’t advertise themselves (common with raw TCP printers like Zebra label printers on port 9100). Manually added printers persist across reboots.

Network Scanning

Use Disable Network Scanning when you do not want ProxyBox to find printers advertised on your local network — for example, when you use only USB printers or add every network printer manually. When scanning is off, the button changes to Enable Network Scanning.

Selecting either button opens a confirmation dialog:

• Disabling warns: “This turns off network scanning. A rescan runs immediately on apply, and discovered network printers will be removed from the list.”
• Enabling explains: “This turns on network scanning. A rescan runs immediately on apply.”

Apply changes the setting and runs the rescan before the dialog closes. Cancel leaves the current setting unchanged. When you disable network scanning, the rescan removes printers found through network scanning. Network printers added with Add Network Printer and printers connected by USB stay in the list.

Printer Details

Each discovered or added printer shows the following:

Field	Description
Model Name	The name advertised by the printer, or Unknown if unavailable.
IP Address	Hostname or IP. Auto-discovered printers show <host>.local:<port>, manually added show <ip>:<port>.
Printer Path	The API path used to send print jobs to this printer. Copy this into your application’s print target.
Tags	Labels you assign to the printer for tag-based routing. See Tags for details.
Test Print	Sends a sample print job to verify the printer works.
Reset Printer	(ZPL printers only) Clears the printer’s buffer and cancels pending jobs. See Resetting a Stuck Printer in the Zebra guide.

Printer-Specific Behavior

Some printer families come with extra behavior or format requirements — Zebra printers get a pre-flight health check before every network print job, Brother label printers require the PDF page size to match the loaded tape, and office printers accept the full set of print options. See the Printer Guides for details by manufacturer.