đ¨ī¸ QZ Tray Required for Printing
This app uses QZ Tray for direct label printing (no browser print dialogs)
Step 1: Download & Install QZ Tray
- Download QZ Tray from: https://qz.io/download/
- Run the installer (Windows:
qz-tray.exe)
- QZ Tray will run in your system tray (look for the QZ icon)
- QZ Tray must be running for printing to work
Step 2: Connect Your Printer
- Connect your LabelRange BT620 printer via USB or Bluetooth
- Install the printer drivers if needed
- QZ Tray will automatically detect your printer
Step 3: First-Time Setup (Certificate)
If you see "UNTRUSTED REQUEST" when printing, the server administrator needs to set up QZ Tray certificates. See QZ_TRAY_SETUP.md for instructions.
Troubleshooting
- "QZ Tray is not available": Make sure QZ Tray is installed and running (check system tray)
- "Cannot read properties of null (sendData)": QZ Tray may not be connected. Try: (1) Restart QZ Tray, (2) Refresh this page, (3) Check if QZ Tray icon shows in system tray
- Labels not printing:: Verify BT620 printer is connected and powered on. Check QZ Tray's printer list.
đĄ Tip: Keep QZ Tray running in the background. You can set it to start with Windows in QZ Tray settings.