# Thermal Printer Module

The Thermal Printer Module is divided into two parts:

* Module Files
* Local Printer Server

### Module Files

In the "**Module Files**" folder, you will find the "**UPLOAD-THIS-MODULE.zip**" file.

You will need to go to **Admin > Modules > Premium Modules** and upload this zip file.

![](https://3900929116-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M-9He_oagk_tkoN-pFE%2F-MD4m40EMgfx2zZZ7N2S%2F-MD4wolgxTwrM-392PTT%2Fupload-module.PNG?alt=media\&token=2816b3eb-2daf-453e-adb7-b8b3003c23a0)

### Local Printer Server

In the zip you download from CodeCanyon after the purchase of this module, you will find "foodomaa-printer-server.zip" file.

#### For Windows 7/8/10

* Extract the contents of "foodomaa-print-server.zip" file to any folder.<br>
* Run the **START.bat** or **START** file.<br>
* **Do not** close the running file. The file always needs to be running in the background for the local server printer connection to be established.<br>

#### For macOS/Linux

* Install XAMPP or WAMP or MAMP or any software that supports your OS and PHP v7.2<br>
* Extract the contents of the files to a folder in www or htdocs (depending on your OS local server path)<br>
* Open a terminal and navigate to the folder where the "foodomaa-printer-server.zip" was extracted.<br>
* Type **`php server.php`** and hit Enter to run the command.<br>
* **Do not** close the running process/terminal. The file always needs to be running in the background for the local server printer connection to be established.

## Configurations

Go to **Admin > Modules > Premium Modules > Thermal Printer Settings**

![](https://3900929116-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M-9He_oagk_tkoN-pFE%2F-MS842hYjR8_w5n2-z45%2F-MS8834wtA_0O9j4YUVk%2Fimage.png?alt=media\&token=e47f82a5-4b45-4224-9f7a-1d1ecc484438)

#### Connector Type

You can choose either Windows / Linux or macOS / Network

#### Connector Descriptor

Here you need to enter the Printer Name or the IP address or the Samba URL of the printer.\
\
Example: \
On a Windows system, if your Printer Name is "EU-T332C" then you will need to enter **EU-T332C** here.\
On Network-based printers, you will need to enter the IP address of the printer.

#### Print Width

You can choose either 3 inches (80mm) or 2 inches (58mm)

**3 Inch Printer is RECOMMENDED for a good print result.**

### **Things to keep a note of**

* Admin and all Store Owners have their own Settings.<br>
* There are certain fields that only Admin can enable/disable. As Admin is considered the Business Owner.<br>
* If Automatic printing is enabled, the printing operation will only happen when an order is accepted by the Store Owner.<br>
* Store Owner can go to the view order page and print the Invoice or KOT again.<br>
* If the local print server is terminated/stopped/closed, the printing operation will not work.

## Supported ESC/POS Printers

Following are the thermal printers that work well with this module

* 3nStar RPT-008
* Approx APPPOS80AM
* AURES ODP-333
* AURES ODP-500
* Bematech-4200-TH
* Bematech LR2000E
* Birch PRP-085III
* Bixolon SRP-350III
* Bixolon SRP-350Plus
* Black Copper BC-85AC
* CHD TH-305N
* Citizen CBM1000-II
* Citizen CT-S310II
* Dapper-Geyi Q583P
* Daruma DR800
* DR-MP200 (manufacturer unknown)
* EPOS TEP 220M
* Elgin i9
* Epson EU-T332C
* Epson FX-890 (requires `feedForm()` to release paper).
* Epson TM-T20
* Epson TM-T20II
* Epson TM-T70
* Epson TM-T70II
* Epson TM-T81
* Epson TM-T82II
* Epson TM-T88II
* Epson TM-T88III
* Epson TM-T88IV
* Epson TM-T88V
* Epson TM-U220
* Epson TM-U590 and TM-U590P
* Equal (EQ-IT-001) POS-58
* Everycom EC-58
* Excelvan HOP-E200
* Excelvan HOP-E58
* Excelvan HOP-E801
* Gainscha GP-2120TF
* Gainscha GP-5890x (Also marketed as EC Line 5890x)
* Gainscha GP-U80300I (Also marketed as gprinter GP-U80300I)
* gprinter GP-U80160I
* HOIN HOP-H58
* Ithaca iTherm 28
* Hasar HTP 250
* Metapace T-1
* Metapace T-25
* Nexa PX700
* Nyear NP100
* OKI RT322
* OKI 80 Plus III
* Orient BTP-R580
* P-822D
* P85A-401 (make unknown)
* Partner Tech RP320
* POSLIGNE ODP200H-III-G
* QPOS Q58M
* Rongta RP326US
* Rongta RP58-U
* Rongta RP80USE
* SAM4S GIANT-100DB
* Senor TP-100
* Sewoo SLK-TS400
* SEYPOS PRP-96
* SEYPOS PRP-300 (Also marketed as TYSSO PRP-300)
* SNBC BTP-R880NPIII
* Solux SX-TP-88300
* Sicar POS-80
* Silicon SP-201 / RP80USE
* SPRT SP-POS88V
* Star BSC10
* Star TSP100 ECO
* Star TSP100III FuturePRNT
* Star TSP-650
* Star TUP-592
* TVS RP45 Shoppe
* Venus V248T
* Xeumior SM-8330
* Xprinter F-900
* Xprinter XP-365B
* Xprinter XP-58 Series
* Xprinter XP-80C
* Xprinter XP-90
* XPrinter XP-Q20011
* Xprinter XP-Q800
* Zjiang NT-58H
* Zjiang ZJ-5870
* Zjiang ZJ-5890 (Also sold as POS-5890 by many vendors; ZJ-5890K, ZJ-5890T also work).
* Zjiang ZJ-8220 (Also marketed as Excelvan ZJ-8220)
* Zjiang ZJ-8250