Skip to content

Using QZ Tray

Jump to bottom
klabarge edited this page Jun 8, 2015 · 38 revisions

#Using QZ Tray

###Background

QZ Tray is a desktop version of the QZ Print application. In anticipation of changes in Google Chrome (dropping support of NPAPI), the QZ Print plugin now offers desktop support via the QZ Tray desktop application beta.

###Installing QZ Tray (Windows)

  1. Install Java 7 or higher from Oracle's website.

  2. Download the appropriate version for your operating system from the qz website.

  3. Install, taking the defaults.

image

Note to Firefox users:

  • Currently, in order for HTTPS to work with Firefox, QZ Tray must be installed (or reinstalled) AFTER Firefox.
  • The certificate installation is performed when Firefox is opened, so closing all running versions of Firefox is required for HTTPS support.
  • Mac users will need to fully quit Firefox via Command (⌘) + Q.
  • These steps are required for Windows, Linux and Mac versions of QZ Tray.

###Running QZ Tray (Windows)

  1. If QZ Tray is installed correctly, an icon will appear in the Windows System Tray.

image

Note: The install dialogue box will not close on its own.

image

  1. A desktop icon is not created by default. To create one, right click the QZ Tray icon down in the tray. Then, go to Advanced > Create Desktop shortcut

###Testing QZ Tray

  1. Open install folder via Tray Icon > Advanced > Open File Location

image

  1. Open sample.html from the demo folder.

image

image

  1. When prompted to allow access, click Allow

Note: This dialog is often hidden behind the browser window. Click the Tray Icon to bring it to the forefront. Hitting refresh will prevent proper loading per bug #11

image

  1. Click Allow to allow the web page to interact with QZ Tray. The page should turn from yellow to gray.

image

  1. Click Detect Printer

  2. Test a print button:

Note: For security reasons, all print requests must be digitally signed. If they are not, a warning will appear on each print. For silent printing, a new signing method must be used. This is further explained in "Signing Messages" section below.

image

###Troubleshooting QZ Tray

  1. Error:

"Could not find the main class: qz.ws.PrintWebSocketServer. Program will exit."

--OR--

"Exception in thread "main" java.lang.UnsupportedClassVersionError: org/eclipse/jetty/server/Handler : Unsupported major.minor version 51.0"

image

Cause: Java 7 or higher is missing from the system. Java 7 or higher is required to run QZ Tray

Resolution: Install Java 7 or higher from the Oracle website.

  1. Error:

The page was loaded over HTTPS, but ran insecure content from 'ws://localhost:8181': this content should also be loaded over HTTPS (wss://).

--OR--

Failed to construct 'WebSocket': An insecure WebSocket connection may not be initiated from a page loaded over HTTPS.

Cause: Some browsers block or warn about the non-secure access of resources when loading a page over HTTPS.

Resolution: HTTPS is supported on versions 1.8.92 and higher so as long as it is install via the full Desktop installer, which configures the system for proper wss:// (compatible with HTTPS).

###Certificates

  1. If you have purchased a product key to generate a certificate, navigate to https://qz.io/login/
  2. Enter in the product key and click Sign In

Note: Make sure there are no blank spaces before or after the product key.

  1. Once signed in, you are given two options. Select QZ Tray.

image

  1. At the next screen you have the ability to generate a CSR (Certificate Signing Request) and a public/private key pair.

You may already have a CSR and/or a public/private key pair. If that is the case, you can upload both of these at this screen.

  1. Fill in the required fields and hit Submit request

    image

Clone this wiki locally