POSpeed Hardware Proxy

Free desktop app that connects your POS hardware to POSpeed — runs quietly in the background!

Windows macOS
No terminal needed
System tray control
Auto-start on boot

Quick Download

All Downloads

Windows

For Windows 10 and Windows 11

Download .exe

Version 1.0.1 • ~20 MB

Super Easy Setup:
  1. Download POSpeedHardwareProxy.exe
  2. Double-click to run — it opens in system tray!
  3. Right-click the tray icon to control it
  4. Done! Configure printers in POS settings
Tip: No terminal window! Runs silently in background. Look for the green icon in your system tray (bottom-right).
Auto-Start Enabled: First time you run it, the app automatically configures itself to start when you log in. No manual setup needed!
Security Note: Chrome/Edge may block download saying "file isn't commonly downloaded." Click "Keep" to proceed. Windows SmartScreen may appear - click "More info" → "Run anyway". This is normal for new software.
Requirements:
  • Windows 10 or later
  • Optional: USB drivers for USB printers (Network printers need no drivers!)
Installation Guide

macOS

For macOS 12 (Monterey) and later

Download for macOS

Version 1.0.1 • ~15 MB

Super Easy Setup:
  1. Download POSpeedHardwareProxy
  2. Double-click to run — it opens in menu bar!
  3. Click the menu bar icon to control it
  4. Done! Configure printers in POS settings
Tip: No terminal window! Runs silently in background. Look for the green icon in your menu bar (top-right).
Auto-Start Enabled: First time you run it, the app automatically configures itself to start when you log in. No manual setup needed!
Security Note: macOS may show "cannot be opened because Apple cannot verify" warning. To fix:
  1. Open Terminal
  2. Run: cd ~/Downloads && chmod +x POSpeedHardwareProxy-macos && xattr -d com.apple.quarantine POSpeedHardwareProxy-macos
  3. Double-click the file to run
Or: Right-click file → "Open" → "Open" (bypasses Gatekeeper)
Requirements:
  • macOS 12 (Monterey) or later
  • Optional: Homebrew + libusb for USB printers (Network printers need no setup!)
Installation Guide

What is the Hardware Proxy?

A lightweight desktop application that connects your receipt printers, cash drawers, and other POS hardware to PoSpeed.

The Hardware Proxy runs locally on your POS terminal and provides a simple HTTP API for PoSpeed to communicate with your hardware devices. No more browser permission dialogs or connection issues!

Key Features
Direct Hardware Access

Connect via USB, Serial, or Network

No Browser Limitations

Works with any browser, no permissions needed

Auto-Reconnect

Automatically reconnects to devices

Secure & Local

Runs locally, no data sent to external servers

Auto-Start on Boot

Automatically configures itself to start when you log in

Runs in Background

System tray/menu bar icon - no terminal window needed

Windows Installation Guide

1
Download the Application

Download POSpeedHardwareProxy.exe from the link above.

2
Install USB Drivers (USB Printers Only)

If you're using a USB printer, install libusb drivers using Zadig:

  1. Download Zadig from zadig.akeo.ie
  2. Run Zadig as Administrator
  3. Options → List All Devices
  4. Select your printer from the dropdown
  5. Select "libusb-win32" or "WinUSB" driver
  6. Click "Install Driver"
3
Run the Hardware Proxy

Double-click POSpeedHardwareProxy.exe to start the server.

You should see a console window showing "Server running on http://127.0.0.1:8888"

4
Configure PoSpeed

In your PoSpeed POS settings:

  1. Go to Point of Sale → Configuration → Point of Sale
  2. Enable "Use Local Hardware Proxy"
  3. Set Hardware Proxy URL to: http://localhost:8888
  4. Configure your printer with the correct USB IDs
  5. Save and restart your POS session
5
Test the Connection

Open a browser and visit:

http://localhost:8888/api/health

You should see: {"success": true, "status": "healthy"}

Running as a Service

For production use, you can install the proxy as a Windows Service using NSSM so it starts automatically. See the documentation for details.

macOS Installation Guide

1
Install Prerequisites

Install Homebrew and libusb:

# Install Homebrew (if not installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install dependencies
brew install libusb
2
Download and Make Executable

Download the file and make it executable:

chmod +x POSpeedHardwareProxy-macos
3
Run the Hardware Proxy

Start the proxy:

./POSpeedHardwareProxy-macos

Or run with sudo for full USB access:

sudo ./POSpeedHardwareProxy-macos
4
Configure PoSpeed

In your PoSpeed POS settings:

  1. Go to Point of Sale → Configuration → Point of Sale
  2. Enable "Use Local Hardware Proxy"
  3. Set Hardware Proxy URL to: http://localhost:8888
  4. Configure your printer with the correct USB IDs
  5. Save and restart your POS session
5
Test the Connection

Open a browser and visit:

http://localhost:8888/api/health

You should see: {"success": true, "status": "healthy"}

Running as a Service

For production use, you can install the proxy as a LaunchDaemon so it starts automatically. See the macOS documentation in the hardware_proxy folder for details.

Supported Hardware

ESC/POS Printers

Epson, Star, Citizen, Bixolon, and more

  • USB connection
  • Serial (RS-232)
  • Network (Ethernet)
Cash Drawers

RJ11/RJ12 connected to printer

  • Pin 2 or Pin 5
  • Automatic opening on order
  • Manual open button
Scales

Serial and USB weight scales

  • Toledo protocol
  • Mettler protocol
  • CAS protocol

Frequently Asked Questions

Yes! Even for network printers, the Hardware Proxy provides better reliability and removes browser restrictions. It also supports cash drawer control which browsers cannot do.

Yes! The Hardware Proxy is completely free and included with your PoSpeed subscription. It's open source and you can even build it yourself from the source code.

Yes, the Hardware Proxy needs to run on each computer that has hardware connected to it. If you have 3 POS terminals with printers, install it on all 3.

Yes! You can use NSSM (Non-Sucking Service Manager) to install it as a Windows Service, or launchd on macOS. See the documentation included with the download for instructions.

Contact our support team at support@pospeed.com or check the documentation included in the hardware_proxy folder. We're here to help!

Need Help?

Our support team is here to assist you with installation and configuration.

Contact Support Start Free Trial