Opal Index

Help CenterM220 print agent setup

Printing

M220 print agent setup

Run the local Mac agent and print 40×30 mm labels to a Phomemo M220.

Who can use it

Platform OWNER account only. Non-owners never see Print controls; print APIs return 403.

What to run locally

On the Mac that has the M220 plugged in (and Labelife quit — it steals USB):

cd print-agent
./install.sh          # discovers CUPS queue, writes config
npm start             # http://127.0.0.1:19220

Optional smoke test:

cd print-agent && npm run test-print

How printing works

  1. Owner opens a parcel / stone / bucket → Print to M220.
  2. Browser calls owner-only /api/print/labels → PNG (QR + ref).
  3. Browser POSTs that PNG to http://127.0.0.1:19220/print.
  4. Agent runs lp to the Phomemo M220 USB queue (40×30 mm media).

Use a desktop browser on that Mac. iPhone Safari cannot reach the Mac’s localhost unless you set up your own tunnel.

Prerequisites

  • Phomemo Mac driver installed; M220 added in System Settings → Printers.
  • Quit Labelife while printing.
  • Agent running (npm start in print-agent/).

In-app status: More → Tools → M220 print agent.