Wiki - Compiling



  1. First, install dependencies (jdk, git, ant, nsis/makeself) per Install Dependencies

  2. Clone the source code per Clone Source Code

  3. Pull in the latest source code

    cd tray
    git pull
  4. Compile


    Optional: Start the software up using this command.

  5. Package

    ant nsis       # <-- Windows installer
    ant pkgbuild   # <-- Apple installer
    ant makeself   # <-- Linux installer

    Note: The installer will be placed in ./out/qz-tray-x.x.x.x, (i.e. .exe, .run, .pkg)


ANT Command Line

ANT Properties File


  1. Download and install JDK 1.7 or higher. (AdoptOpenJDK 11 is recommended)

  2. Download and install IntelliJ from

  3. Launch IntelliJ

  4. When prompted, click Check out from Version Control (GitHub)

    Auth type: password
    Login: <github username>
    Password: <github password>

  5. Clone Repository

    Git Repository URL:
    Parent Directory: <leave default, usually "C:\Users\username\IdeaProjects">
    Directory Name: <leave default, "tray">
    Note, if the Parent Directory doesn't exist, create it.

  6. Open the project

  7. Switch to project view using ALT + 1

  8. Click File, Project Structure

    • Verify Project SDK is correct. This must be 1.7 or higher (QZ Tray 2.1 requires 1.8 or higher).
    • If <No SDK>, click New, JDK and browse to the appropriate install location, e.g. C:\Program Files\Java\jdk1.8.0_XX
  9. From the Project Explorer, Navigate to:

    • tray, src, qz, ws, PrintSocketServer
    • Right Click, Run
    • On Windows, a firewall prompt may appear, click Run
  10. Exit PrintSocketServer by locating it in the System Tray, Right Click, Exit

    • Alternately, you can click Stop within IntelliJ from bottom left "Run" tab
  11. NOTE: for version 1.9 only

    • Click File, Project Structure and Navigate to Modules, Dependencies Tab
    • If plugin.jar shows an error, remove it and re-add it:
      • Click plugin.jar, Click - to remove
      • Click + to add, JARs or Directories
      • Browse to the SDK location, e.g. C:\Program Files\Java\jdk1.8.0_XX\jre\lib\plugin.jar
      • Make sure plugin.jar is at the top of the Dependencies listing, use arrows if needed, OK
  12. Optional to enable HTTPS support in IntelliJ (<=2.0 only)

    • If a version of QZ Tray is NOT installed, generate a qz-tray.jks and manually

      • Create a 2048 bit RSA java keystore with an alias qz-tray
      • Create a properties file with the following lines in it:
    • If QZ Tray is installed, you may use the located in the installation folder.

    • Click on in the Projects Navigator

    • From the file menu click Run, Edit Configurations...

    • In the VM Options add -DsslPropertiesFile=<path-to>/

      • Windows: -DsslPropertiesFile="C:\\Program Files\\QZ Tray\\"


Edit this page