Integrated Printing Troubleshooting

Now available with RepairQ 1.10 and above, Integrated Printing offers a wide variety of new setups, configurations, and automations. Here are a few solutions for common problems you may come across.

(This article will be updated as new problems arise.)

  • Downgrade to an older version of QZ
    • We have come across a couple of instances where an older version of QZ works better than the latest updates. Uninstall QZ from your machine and then reboot.
    • Head to this website to download version 2.0.2 (.exe for Windows, .pkg for MacOS):
    • Install 2.0.2 and open the QZ Tray app, then try printing again

  • If you need to bypass Integrated Printing and print manually
    • If you need to manually print a ticket receipt and cannot get Integrated Printing to work at any given time, there is an option labeled "Print with browser dialog" in the new print menu. This option gives you the ability to print without using the integration at any time. Use either "Command + P" or "Control + P" to print from there.

 

  • Make sure you have the latest version of Java installed on your computer.
  • Ignore the QZ app in any security software you have running, i.e. Avast, Norton, etc.

  • Close the QZ tray app and then re-open it.

  • Make sure you only have one version of QZ installed on your computer.
    • If you feel like you have installed more than one copy, uninstall anything related to QZ and reinstall the correct version.

  • Clear your Chrome browser cache
    • Navigate to Settings --> Show Advanced Settings --> Clear Browsing Data.
    • Only check "Cached images and files" and click "Clear Browsing Data".
    • Close Chrome completely, then open it back up and try again.

  • Check your printer settings. We recommend using the Metric (millimeter) settings for most Star and Epson printers, as they have proven to work better. We do not know yet whether inches or millimeters will work better for other printers or not.

  • Install Windows Printer Driver Downloads for Thermal Label Printers, Card Printers, and Other Specialty Printers
  • Make sure the paper height is not set higher than 100 inches or 2500 millimeters.
    • For some Star and Epson receipt printers, we suggest trying this configuration:

    • For other Star receipt printers, try this configuration: (72 mm width x 200 mm height)
    • For the Epson TM-T88V receipt printer, try using this configuration:
      • Metric: 72 mm x 200 mm, 7 DPI

  • If you think you have everything setup properly but it the print job screen stays open and the job never completes:
    • Download and install the latest version of Java. Check to make sure which version of Windows you are running (32 bit vs 64 bit):
    • Uninstall any older versions of Java when it prompts you to.
    • Reboot your computer
  • Make sure you only have one copy/version of the QZ Tray app installed on your computer.
    • Having more than one (e.g. QZ and QZ (1)) can force miscommunication.
    • If in doubt, uninstall any programs related to QZ and re-download and install.
    • Reboot computer, make sure QZ is running in the tray, and try again.

  • If you receive the "Cannot call method public void…" error:
    • 1 Dot per inch = 0.0393701 Dots per mm
      203 DPI = 7.9921303 DPM
      300 DPI = 11.81103 DPM
      600 DPI = 23.62206 DPM
    • Close the QZ Tray app from the tray
    • Open "Command Prompt"
    • Copy and paste this exact command and hit Enter on your keyboard
      java -Xms512M -jar "%PROGRAMFILES%\QZ Tray\qz-tray.jar"
    • Source: https://qz.io/wiki/faq#debugging-qz-tray

    • Check your DPI. Make sure it is converted from Dot Per Inch to Dot Per Millimeter, if using Metric. 
    • Close down the QZ Trap app and reopen
    • Download and install the latest version of Java. Check to make sure which version of Windows you are running (32 bit vs 64 bit):
    • Uninstall any older versions of Java when it prompts you to.
    • Reboot your computer
    • If still showing that error, try launching the QZ Tray app from the command prompt, which allows you to see error output from QZ and/or start QZ Tray with more memory (default is 512M, try 1024M if all else fails).
  • If you receive the "Error: connection closed before response received" popup message:
    • 1 Dot per inch = 0.0393701 Dots per mm
      203 DPI = 7.9921303 (~8) DPM
      300 DPI = 11.81103 (~12) DPM
      600 DPI = 23.62206 (~24) DPM
    • Check your DPI. Make sure it is converted from Dot Per Inch to Dot Per Millimeter, if using Metric.
    • Close down the QZ Tray app and reopen
    • Make sure Java is updated
    • Wipe cache in Chrome
    • Reboot computer

  • If you have a cash drawer connected to your receipt printer and it is not being triggered to open when printing a receipt:
    • Make sure no third party print utilities (usually installed with the printer) are interfering with the print. Sometimes those utilities override the print jobs with their own settings and need to either be disabled, or adjusted accordingly.
    • The communication between different applications and the driver seems to be the common variable in this problem.

  • If your receipt printer acts like it is going to print but only prints out a one inch blank receipt:
    • 1 Dot per inch = 0.0393701 Dots per mm
      203 DPI = 7.9921303 (~8) DPM
      300 DPI = 11.81103 (~12) DPM
      600 DPI = 23.62206 (~24) DPM

    • Check your DPI. Make sure it is converted from Dot Per Inch to Dot Per Millimeter, if using Metric.
  • If the QZ Tray app randomly disconnects or closes/crashes, even when not in use:
    • Make sure you have the minimum recommended 6 GB RAM.
    • Close down the QZ Tray app and reopen.
    • Uninstall the QZ Tray app and reinstall it.
    • Disable any antivirus software or allow the QZ Tray app to bypass it.
    • Reboot your computer.
    • Adjust your "Paper Height" down lower, from ~78 inches (2000 mm) down to ~20 inches (500 mm).

  • QZ not working with Firefox 54
    • Firefox 54 recently broke SSL websites with all versions of QZ Tray. For now, please visit https://localhost:8181 and add an exception, then attempt to use the software again. Alternately, they may switch to another browser.
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk