This connector allows printing from any device (PC/Mac/iPhone) on your local network (LAN) to a single USB printer.
1. 🐍 Prerequisites & Environment
Install Python (3.10+): Check "Add python.exe to PATH" during installation.
Install OpenSSL: Ensure the `openssl.exe` tool is installed and accessible in your system's PATH.
2. 🖨️ Install Printer Driver (Zadig)
This allows Windows to use the USB printer in raw mode:
Connect your POS printer via USB and turn it on.
Download & run Zadig (from zadig.akeo.ie).
Go to Options > List All Devices and check the box.
Find your printer and select the libusbk driver.
Click "Replace Driver" or "Install Driver".
3. 🔑 Run and Setup Certificates (Cero-Config)
The connector generates unique security keys for your network:
Run the Connector: Execute the `webUSB.exe` file.
The console will run/log the Hostname and Local IP (e.g., 192.168.0.3 or localhost).
The connector automatically generates `cert.pem` and `key.pem` for your network.
4. 📱 Trust Certificate on iOS/Mac (CRITICAL)
This solves the SSL block on mobile devices:
Get session at (e.g., 192.168.0.3 or localhost)
https://localhost:5123/install_cert
Example: https://192.168.0.3:5123/install_cert
Accept First Warning: You must click "Advanced" and "Accept Risk and Continue" to bypass the initial SSL block and start the download.
Download Profile: Tap "Allow" to download the profile.
Install Profile: Go to iPhone Settings > Profile Downloaded. Tap the profile and choose "Install".
Enable Trust (Final Step): Go to Settings > General > About > Certificate Trust Settings. Activate the switch for the new "MagicInvoiceApp" certificate.
5. 🚀 Daily Use
Run `webUSB.exe`.
In the app, click "Refresh List" and "Connect" to your printer.
Use this website from any device on your LAN.