M220 print agent setup

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

Overview

Opalry can send 40×30 mm thermal labels directly to a Phomemo M220 on your Mac. A small local agent handles the USB connection — no cloud printing required.

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

Open a parcel, stone, or bucket → Print to M220.
Opalry generates a label image (QR + ref) in your browser.
Your browser sends that image to http://127.0.0.1:19220/print.
The agent prints 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.