Install a Printer - Epson TM on Windows (JPOS)

How to install an Epson receipt/label printer on Windows

- Windows 7, Vista and XP are supported (note there is no Epson TM JavaPOS driver for Apple OSX)

- The Epson JavaPOS driver does not support printing to the parallel port. USB is recommended. Serial and network printers are also supported.

If there is already an Epson driver installed on your terminal machine, please uninstall it before attempting to install the JavaPOS driver. The Epson Windows Advanced Printer Driver, in particular, interferes with the JavaPOS driver and will cause the printer connection to fail. 

You must be logged in to Windows as an administrator.

With your terminal installed, but not running, follow the steps below to install the Epson JavaPOS printer driver for your TM printer. Do this before connecting your printer.


1. Before you start: Ensure the Bluestore Live Terminal application is not running and the printer is disconnected. Uninstall any Epson receipt printer drivers currently on the machine e.g. Epson Windows Advanced Printer Driver.

2. Note the Location of Your Java (jre) Install

Locate the directory in which you have your java runtime enviroment installed, normally C:\Program Files\java\jre7.

This location will be referred to throughout this document as <java>.

It is important, particularly if you have more than one java installation, to use the same one (i.e. your current active jre) throughout this install process.

3. Download the JavaPOS Pack for Epson TM printers

The installer for Epson TM Printers is available from our downloads page

JavaPOS Driver Downloads

Download and unzip the file 'JavaPOS Pack - Epson TM Series Printers'.

Locate the following two files in the downloaded zip:



Copy these two Java Advanced Iimaging files into the java external library directory which is at <java>\lib\ext.

i.e. in a default set up this will be C:\Program Files\java\jre7\lib\ext\


4. Start the driver installation

Run the other file in the downloaded zip: Epson_JavaPOS_ADK_11113.exe

(note the following screenshots refer to version 1.11.12 but the steps are the same).




Press ok.

Click through the introduction and accept the license agreement.

On the next page the installer will ask you to select a JVM (Java Virtual Machine). If you have just a single edition of java on your PC then simply highlight it, or choose the latest JRE version if you have more than one displayed (note: ensure you always refer to the same jre throughout this process).




Press next to choose the install set and select 'user'...




Press next. The following screen allows you to choose the folder location for the service files. Note: In some cases the installer can automatically detect this location in which case the screen will be skipped.

Choose the second option so that the files are saved to the <java>\lib\ext\ folder.




Press next and choose the method by which your Epson TM printer will connect to the computer.




On the following screen, check the box 'use existing jpos.xml file' - we want to use the jpos.xml file that is delivered with the Bluestore Live terminal install.

Browse to the location of the jpos.xml file which is in the user data at  ..\Bluestore Live POS\terminal\data\pos\.

If you kept the defaults during the terminal install it will be at:

Win 7/Vista: C:\Users\<your windows user>\AppData\Roaming\Bluefish Retail

Win XP: C:\Documents and Settings\<your windows user>\Application Data\Bluefish Retail\

(note that on win xp, the Application Data folder is hidden by default. To display it, open my documents and go to tools - folder options, go to advanced and click 'show hidden files and folders'.)



Review the pre-installation summary on the following page then press 'install'.



Although the installer will ask you to reboot, this is normally not necessary unless you have uninstalled previous versions of the driver or have the POS terminal application running during the install.


5. You are now ready to use an Epson TM printer with the Bluestore Live terminal

Plug in the printer.

If the printer is connected via a serial port, first configure the device as described in 'configuring a serial device'.

For USB devices, there is no further set up required.

Start the terminal, log in as a manager, and navigate to tools - hardware configuration




Highlight the 'model' under receipt printer and press 'Change Option'.

The list of supported printers will be displayed. Navigate down to the Epson section and select your device.




If your particular model is not listed, it is worth trying a similar one as it may work, alternatively an unlisted Epson printer can be added by generating a jpos.xml entry for your device. The Epson SetupPOS application, delivered with the JavaPOS driver, can be used to generate a new entry in the jpos.xml file which will then allow it to appear in the device list. If you need advice on this then please contact us for help.

Click ok to close the printer selection dialogue.

For USB printers, there should be no need to change any of the settings for the device. For serial printers, click 'device properties' (after first saving your selection) and set the correct port name (com1, com2 etc) and serial connection settings for your printer.

Enable the receipt printer and save.

The printer can be tested using the 'test printer' option in the tools menu.

Have more questions? Submit a request


Article is closed for comments.
Powered by Zendesk