# 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.
### 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.
* Run the **START.bat** or **START** file.
* **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.
#### For macOS/Linux
* Install XAMPP or WAMP or MAMP or any software that supports your OS and PHP v7.2
* Extract the contents of the files to a folder in www or htdocs (depending on your OS local server path)
* Open a terminal and navigate to the folder where the "foodomaa-printer-server.zip" was extracted.
* Type **`php server.php`** and hit Enter to run the command.
* **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**
#### 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.
* There are certain fields that only Admin can enable/disable. As Admin is considered the Business Owner.
* If Automatic printing is enabled, the printing operation will only happen when an order is accepted by the Store Owner.
* Store Owner can go to the view order page and print the Invoice or KOT again.
* 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
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.foodomaa.com/premium-modules/thermal-printer-module.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.