Inkless — Thermal Printer App

Setup Instructions

What's in this folder

inkless/
├── index.html                    ← The web UI
├── launcher.py                   ← Python launcher
├── launcher.exe                  ← (after you build it) — the thing to double-click
└── plugin/
    └── escpos-printer-plugin.exe ← Parzibyte plugin (download separately)

---

Step 1 — Download the Parzibyte Plugin

1. Go to: https://github.com/parzibyte/plugin-impresora-termica/releases
2. Download the latest Windows .exe (e.g. plugin-impresora-termica-windows-amd64.exe)
3. Rename it to: escpos-printer-plugin.exe
4. Place it inside the plugin/ folder next to launcher.py

---

Step 2 — Install Python (if not already)

• Download Python 3.8 from: https://www.python.org/downloads/release/python-3810/
• During install, check "Add Python to PATH"
• Python has NO extra libraries needed — only standard library is used

---

Step 3 — Build the .exe (one time only)

Open Command Prompt in the inkless/ folder and run:

pip install pyinstaller
pyinstaller --onefile --noconsole --name Inkless launcher.py

The final Inkless.exe will appear in the dist/ folder.

Copy Inkless.exe out of dist/ and place it alongside index.html and the plugin/ folder.

---

Step 4 — Final folder structure to ship

inkless/
├── Inkless.exe
├── index.html
└── plugin/
    └── escpos-printer-plugin.exe

Zip this folder and send it. The user just double-clicks Inkless.exe.

---

How it works for the end user

1. Double-click Inkless.exe
2. Browser opens automatically with the Inkless page
3. Type anything → click Print → it comes out of the thermal printer

---

Printer name

The printer name is currently set to: Gobbler SP-POS894UED To change it, open index.html and find this line near the top of the script:

const PRINTER_NAME = 'Gobbler SP-POS894UED';

Change it to whatever name appears in Windows → Devices and Printers.

---

Troubleshooting

Issue	Fix
Green dot not showing	Make sure plugin .exe is running
"Could not reach printer plugin"	Restart Inkless.exe
Wrong printer name	Update PRINTER_NAME in index.html
Nothing prints	Check printer is on & USB connected