UltimatePOS

  1. Home
  2. Docs
  3. UltimatePOS
  4. Hardware Support
  5. Setting up a Thermal Printer for Receipt Printing

Setting up a Thermal Printer for Receipt Printing

Thermal Printers:

2 types of thermal printers are available in the market:

  1. Thermal Line Printers. (Supported after UltimatePOS version > 2.19): Easy to Install & Use.
  2. Thermal ESC/POS printers: Complicate to install & use, also some languages & curriences symbol may not be supported.
We recommend using a Thermal Line printer for the ease of setup and good print quality.

Browser based printing or Thermal Line Printers or Direct Thermal: (Recommended)

Thermal line printers also called as Direct Thermal, are easy to install & use. Also they supports browser based printing. For better result use paper with width 79mm.

To use a thermal line printer follow these steps:

  1. Setup the printer on your computer with the appropriate driver which comes with the printer.
  2. Go to Settings -> Business Locations -> Settings (green color button for each location). Here change the Receipt Printer Type to Browser based printing and save it.
  3. In the invoice layout select the Design as Slim

You’re now ready to use the printer, no more steps required.


Thermal ESC/POS printers:

Setting an ESC/POS thermal printer involves 3 steps:

  1. Adding a Printer
  2. Configuring business location to use the added printer.
  3. Installation Pos Print server.

Step1: Adding a Printer

  1. Add a new printer from Settings -> Receipt Printer
  2. Select the appropriate Connection Type:
    1. For “Network” provide the IP Address of the printer.
    2. For “Windows” map the printer to a file and provide the path of the file. You can do this by sharing the printer to your localhost.
      The path will be in this format:

      ,

      smb://localhost/my_printer_name
      
      OR
      
      smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

      >

    3. For “Linux” your printer device file will be somewhere like /dev/lp

      ,

      smb://localhost/my_printer_name
      
      OR
      
      smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

      (parallel), /dev/usb/lp1 (USB), /dev/ttyUSB

      ,

      smb://localhost/my_printer_name
      
      OR
      
      smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

      (USB-Serial), /dev/ttyS

      ,

      smb://localhost/my_printer_name
      
      OR
      
      smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

      (serial)

  3. Select the capability profile and add character per line supported in the printer.
  4. Save the Printer configuration.
  5. Check the video below for more details on setting it.

Step2: Configuring Business Location to use printer:

  1. Go to Settings -> Business Settings.
  2. For a particular business location, go to “Settings” in actions column.
  3. Change “Receipt Printer Type” to “Use Configured Receipt Printer
  4. Select the “Receipt Printers” from the list of Receipt Printers
  5. Click on Update.

Step3: Installing POS Print Server

For printing via receipt printer, you will need to install a “pos print server” on your local computer from which UltimatePOS is used.

  1. Download the server from this link. by clicking on “Download Repository”
  2. Unzip the zip file.
  3. Rename the unzipped folder to “pos_print_server”.
  4. Move the pos_print_server to document root (which is htdocs in XAMPP).
  5. Open Command Prompt or also called terminal. And go to the “pos_print_server” directory. You can go to this directory using “CD” command in the command prompt.
  6. From the Command Prompt which is now inside pos_print_server directory run the below command:
    php server.php
    After running the command it will start the print server and show a message similar to below:
    smb://localhost/my_printer_name OR smb://computer_name/my_printer_name (where my_printer_name is name of the printer)18/

    ,

    smb://localhost/my_printer_name
    
    OR
    
    smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

    2/print-3

    ,

    smb://localhost/my_printer_name
    
    OR
    
    smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

    ,

    smb://localhost/my_printer_name
    
    OR
    
    smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

    x46.jpeg" alt="" width="443" height="68" />You may receive "Unrecognised command PHP", in that case, add PHP command to your environment variable. (smb://localhost/my_printer_name OR smb://computer_name/my_printer_name (where my_printer_name is name of the printer)j

    ,

    smb://localhost/my_printer_name
    
    OR
    
    smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

    j4&sourceid=chrome&ie=UTF-8" target="_blank" rel="noopener noreferrer">Google search result)

  7. Now we are ready to go. Try creating a test sell from the pos screen and it should print in your thermal printer. If you haven't added a printer then follow the steps mentioned in "Step1: Adding a Printer" and it should work.

Great, now we're ready to print on a thermal printer.

Give it a test drive.

Video Guide:

Follow the steps as mentioned in this video up to 2.

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

minutes.

Use pos_print_server instead of the Github repo mentioned here.

Go to POS screen, add a test invoice and check if it prints. If not please check if the pos receipt server is running or not.

smb://localhost/my_printer_name OR smb://computer_name/my_printer_name (where my_printer_name is name of the printer)18/

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

2/compatibility-3

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

x181.png" alt="" width="5

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

1" height="3

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

2" />

ESC/POS Printers

Many thermal receipt printers support ESC/POS to some degree. This driver has been known to work with:

AURES ODP-333
AURES ODP-5

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

Bixolon SRP-35

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

III
Citizen CBM1

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

-II
Citizen CT-S31

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

II
Daruma DR8

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

EPOS TEP 22

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

M
Epson TM-T88II
Epson TM-T88III
Epson TM-T88IV
Epson TM-T88V
Epson TM-T7

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

Epson TM-T82II
Epson TM-T2

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

Epson TM-T2

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

II
Epson TM-T7

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

II
Epson TM-T81
Epson TM-U22

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

Epson TM-U295 (requires release() to release slip).
Epson TM-U59

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

and TM-U59

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

P
Epson FX-89

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

(requires feedForm() to release paper).
Equal (EQ-IT-

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

1) POS-58
Excelvan HOP-E58
Excelvan HOP-E2

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

Excelvan HOP-E8

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

1
Excelvan ZJ-822

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

Gainscha GP-589

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

x (Also marketed as EC Line 589

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

x)
Gainscha GP-U8

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

3

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

I (Also marketed as gprinter GP-U8

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

3

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

I)
gprinter GP-U8

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

16

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

I
Hasar HTP 25

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

Metapace T-1
Metapace T-25
Nexa PX7

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

Okipos 8

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

Plus III
Orient BTP-R58

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

P-822D
P85A-4

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

1 (make unknown)
Rongta RP326US
Rongta RP58-U
SEYPOS PRP-3

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

(Also marketed as TYSSO PRP-3

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

)
Silicon SP-2

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

1 / RP8

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

USE
Star TSP1

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

ECO
Star TSP1

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

III FuturePRNT
Star TSP-65

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

Star TUP-592
SPRT SP-POS88V
Xprinter F-9

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

XPrinter XP-Q2

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

11
Xprinter XP-Q8

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

Xprinter XP-8

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

C
Venus V248T
Zjiang NT-58H
Zjiang ZJ-587

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

Zjiang ZJ-589

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

T (Marketed as POS 589

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

T)
Zjiang ZJ-589

,

smb://localhost/my_printer_name

OR

smb://computer_name/my_printer_name    (where my_printer_name is name of the printer)

K

Was this article helpful to you? Yes 8 No 9

How can we help?