Troubleshooting Hatch

Hatch is an optional installable program that works with your browser to manage complex printing needs (such as printing to different printers under different circumstances).

Refer to the section called “Downloading and Installing Hatch” for installation instructions.

Troubleshooting Hatch

Operating System

Hatch will only work with Windows 7, 8, and 10 at this time. If you are going to submit a ticket, include the version in your ticket, as well as whether it is 32 or 64-bit. You can find this by:

  1. Click on the Windows Start button.
  2. Right-click on Computer.
  3. Click on Properties.


Verify that the Java Runtime Environment (JRE) is up to date (version 8 update 161 or higher). If you are unsure which version you have, view your computer’s list of programs or simply download and install the latest version from:


You can also check to be sure that your operating system is able to find the path to Java:

  1. Open up a command window (Start Menu, type in cmd).
  2. Type in: java -version
  3. You should see the Java version number listed. If there is a problem, you will see an error message.

Hatch Program

Verify that you are running the correct version of Hatch (0.3.2). You can see this from your computer’s list of programs Control Panel > Programs and Features.

Confirm a "lib" directory exists in the Hatch install directory and that it includes a hatch.jar file


Test Hatch

  1. Open up a command window (Start Menu, type in cmd).
  2. Enter command C:\>cd %ProgramFiles(x86)%\
  3. Enter command C:\Program Files (x86)\Hatch>hatch.bat test

  4. Either take a screenshot or copy and paste the text that appears in the command window.

Hatch Extension

Verify that you are running the correct version of the Hatch Chrome Extension (0.2.2).

  1. Click Menu.

  2. Click More Tools.
  3. Click Extensions.
  4. Scroll down to Hatch Native Messenger.
  5. Verify that it is version 0.2.2 and Enabled.
  6. When the Hatch Extension is installed and enabled, a small yellow icon should appear in the top-right corner of the browser:

Hatch Extension Console Messages:

  1. In Chrome, click Menu.
  2. Select More Tools.
  3. Select Extensions.
  4. Enable Developer Mode.
  5. Choose Hatch Native Messenger.
  6. Click on the link that says "background" page. (This will open a new window.)
  7. Select the Console tab.
  8. Change the "Default" drop down to be sure that Verbose is checked.
  9. Either take a screen shot or copy and paste the text that appears in the console when you see the errors occurring. Be sure to include any of the errors that display in red.

Copyright © 2008-2018, BC Libraries Cooperative