Before you begin
You need a Windows 10 or Windows 11 64-bit computer, permission to install the application, and access to your POS printer settings. The POS must support RAW TCP/IP output or a Windows printer queue.
Step-by-step setup
- Install POS Printer Emulator. Run the all-in-one installer. It adds the desktop application, local background listener, firewall rule, and required runtime.
- Open the application. Confirm the header reports that the listener is running on port 9100.
- Find the Windows computer’s IPv4 address. Use that address when the POS runs on another device. For testing on the same computer, use
127.0.0.1. - Configure the POS destination. Choose RAW TCP/IP printing, enter the emulator computer’s address, and use port
9100. If the POS prints only through Windows, use the built-in Printer Setup Wizard or create a Standard TCP/IP port. - Send a test receipt. Complete a test sale or use the app’s Test receipt button.
- Inspect the result. Compare the live receipt preview with the intended layout, then check Commands, Raw data, and Job details for warnings or unexpected bytes.
Troubleshooting
- No job appears: confirm the listener is running, the IP address and port are correct, and Windows Firewall allows the application.
- Receipt formatting is wrong: inspect parsed ESC/POS commands and unsupported warnings.
- A blank receipt appears: open Raw data to confirm the POS sent printable content rather than only initialization commands.
Keep test data appropriate for your environment. Receipt contents remain local, but avoid using real cardholder or sensitive customer data in development tests.
