🖨 Free Download · No Subscription Required

MenuForma
Print Agent

Silent, direct ESC/POS printing for your thermal printer. No browser print dialog. No garbled text. Works with any thermal printer via USB or network.

Windows 10/11 x64 · .exe installer · v1.0.0 · Free

Get started in 6 steps

1

Download & Install

Download the installer for your operating system and run it. The app will be added to your Applications folder (Mac) or Start Menu (Windows).

2

macOS Only: Fix "App Damaged" Warning

🍎 macOS only

If macOS shows '"MenuForma Print Agent" is damaged', open Terminal and run: xattr -cr "/Applications/MenuForma Print Agent.app" — then reopen the app. This is a macOS security prompt for apps without Apple notarization, not an actual error. Windows users can skip this step.

3

Plug In Your USB Printer

Connect your thermal printer to your computer via USB cable. Make sure the printer is powered on.

4

Scan & Select Printer

Open Print Agent → click the USB tab → click "Scan USB" → select your printer from the list. It will be saved automatically and USB mode will be activated.

5

Test Print

Click "Test Print" in the Print Agent to verify the printer is working correctly. You should see a test receipt print out.

6

Connect in MenuForma

Go to menuforma.com → Dashboard → Orders → click "Print & Receipt Settings" → select "Print Agent". Your printer is now ready for silent, automatic ESC/POS printing.

Why Print Agent?

Browser printing (window.print)

  • • Print dialog pops up every time
  • • Chinese / special characters garbled
  • • No auto paper cut
  • • Can't open cash drawer
  • • Unreliable formatting on thermal paper

MenuForma Print Agent

  • • Silent printing — no dialogs
  • • Full Unicode / multilingual support
  • • Auto paper cut after each receipt
  • • Cash drawer trigger support
  • • Perfect thermal paper formatting

How it works

MenuForma Website
menuforma.com
Print Agent
ws://localhost:8765
Thermal Printer
USB or Network (TCP 9100)

The Print Agent runs locally on your computer and bridges the website to your printer via WebSocket. ESC/POS commands are sent directly — no cloud, no latency.

Compatible Printers

🖨 Epson TM-T20 / T82 / T88
🖨 Star Micronics TSP100 / TSP650
🖨 Bixolon SRP-350 / SRP-380
🖨 SNBC BTP-S80 / BTP-R880
🖨 Xprinter XP-58 / XP-80
🖨 Rongta RP58 / RP80
🖨 Goojprt PT-210 / MTP-3
🖨 Any ESC/POS compatible printer

Any ESC/POS compatible thermal printer is supported. If your printer supports ESC/POS commands, it will work.

Installation Notes

Your operating system may show a security warning the first time you open the app. This is normal for apps distributed outside the App Store or Microsoft Store.

🍎

macOS — "App can't be opened" warning

Gatekeeper security check (normal for unsigned apps)

1

Double-click the .dmg file to mount it

Drag the MenuForma Print Agent icon to your Applications folder

2

When you see "App can't be opened" — click OK to dismiss

Do not click "Move to Trash"

3

Open System Settings → Privacy & Security

Scroll down to the Security section

4

Click "Open Anyway" next to the MenuForma Print Agent entry

You may need to enter your Mac password to confirm

5

A final dialog will appear — click "Open" to launch the app

You only need to do this once. The app will open normally from now on.

Why does this happen? macOS Gatekeeper checks if apps are signed by an Apple-registered developer. MenuForma Print Agent is safe — this warning appears because it is distributed directly, not through the Mac App Store.

🪟

Windows — "Windows protected your PC" warning

SmartScreen security check (normal for unsigned apps)

1

Run the downloaded .exe installer

A blue SmartScreen dialog may appear

2

Click "More info" in the dialog

This reveals the "Run anyway" button

3

Click "Run anyway" to proceed with installation

The installer will continue normally. You only need to do this once.

Why does this happen? Windows SmartScreen checks if apps have a publisher certificate. MenuForma Print Agent is safe — this warning appears because it is distributed directly, not through the Microsoft Store.

Release Notes

v1.0.0Initial Release
May 2025
  • Silent ESC/POS printing via WebSocket (no browser print dialog)
  • USB printer auto-detection and network (TCP 9100) support
  • System tray icon with status indicator
  • Custom receipt template support (logo, items, totals, footer)
  • Auto-print on new order with on/off toggle
  • Available for macOS (Apple Silicon + Intel) and Windows 10/11

FAQ

Is it free?

Yes, MenuForma Print Agent is completely free to download and use.

Does it need to run all the time?

Yes, the Print Agent needs to be running on your computer to receive print jobs. It runs silently in the system tray / menu bar and uses minimal resources.

Does it work on multiple computers?

Yes, install it on each computer that has a printer connected. Each installation is independent.

What if my printer is connected to a different computer on the network?

Use the Network (IP) mode. Enter the printer's IP address and port 9100. The printer just needs to be accessible on the same network.

Is my data sent to the cloud?

No. Print jobs go directly from your browser to the local Print Agent to your printer. No print data leaves your local network.

Ready to print smarter?

Download the Print Agent and start printing receipts in seconds.