Skip to content
This repository has been archived by the owner on Dec 10, 2018. It is now read-only.

Using QZ Tray

klabarge edited this page Jun 19, 2015 · 32 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.

This tutorial goes over installing, running, and testing QZ Tray. Navigate to one of the following links if you already have QZ Tray installed and working with the sample.html page.

###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