MessyPoly Print Bridge — README
================================

What this is
------------
Print Bridge is a small helper that runs on your computer. It lets MessyPoly
talk to your printer host (OctoPrint, Moonraker, PrusaLink, or Bambu LAN)
without sending your printer URL or credentials to MessyPoly’s servers.

Leave the bridge window open while you work. Closing it stops the connection.


Once it is running
------------------
You should see a message like:
  MessyPoly Print Bridge starting on http://127.0.0.1:18765

In MessyPoly (same computer as the bridge):

1. Open your model → Prepare for print → step 3, “Send the G-code to
   your printer”.
2. Choose the host software, type a name for your printer (for example
   “Workshop”), and click Add. This is only a name — not the address.
3. Click Link, paste the address and credential for that host, then Save.
4. Download the 3MF from MessyPoly and slice it in your slicer.
5. Click Send G-code… and choose the .gcode file your slicer exported.

Unlink removes the saved printer connection from this computer.
MessyPoly’s cloud never stores the address or API key.


What you need
-------------
• A printer host reachable from this computer (same Wi‑Fi / network),
  or for developers:
    npm run print-bridge:fake-octoprint
      (URL http://127.0.0.1:18766 · API key messypoly-fake-key)
    npm run print-bridge:fake-moonraker
      (URL http://127.0.0.1:18767 · API key messypoly-fake-key)
    npm run print-bridge:fake-prusalink
      (URL http://127.0.0.1:18768 · password/key messypoly-fake-key)
    npm run print-bridge:fake-bambu
      (URL http://127.0.0.1:18769 · access code messypoly-fake-key;
       serial 01P00A000000001 when prompted).
• Credentials: OctoPrint/Moonraker API key, PrusaLink password (or API key),
  or Bambu LAN access code (+ serial if TLS does not provide it).
• Your own sliced .gcode file — the bridge only uploads G-code, not 3MF/STL.
  Bambu start uses LAN FTPS + MQTT gcode_file; some firmware prefer .gcode.3mf
  project handoff (out of scope here).


Stopping
--------
Press Control+C in the bridge window, or close the window.


Starting again later
--------------------
See the “How to start…” file in this folder for your operating system.
Mac users: if macOS blocks the starter, that file also explains Open Anyway.
