Conductor OSC Bridge
====================

Relays hand-tracking data from conductor.zone.net.au to Pangolin Beyond
via OSC over your local network.


QUICK START
-----------

Option A — Node.js (recommended):
  1. Install Node.js from https://nodejs.org (LTS version)
  2. Edit config.json if Beyond is not on this machine
  3. Double-click start-bridge.bat (Windows) or run ./start-bridge.sh (Mac/Linux)
  4. Leave this window running

Option B — Standalone .exe (Windows only):
  1. Double-click conductor-bridge.exe
  2. Edit config.json if Beyond is not on this machine
  3. Leave this window running

Then open conductor.zone.net.au — it will auto-detect the bridge.


CONFIG (config.json)
--------------------

  relayUrl   — VPS relay address. Usually no change needed.
  beyondHost — IP of the machine running Beyond.
               Default: 127.0.0.1 (same machine as this bridge)
               Change to e.g. "192.168.1.100" if Beyond is on another PC.
  beyondPort — Beyond's OSC input port. Default: 8000.


BEYOND OSC SETTINGS
-------------------

In Pangolin Beyond:
  Settings → Configuration → OSC
  ☑ Enable receiving OSC messages
  Incoming port: 8000


TROUBLESHOOTING
---------------

"Node.js not found"
  → Install Node.js from nodejs.org, then restart your terminal.

Bridge connects but Beyond doesn't respond
  → Check Beyond OSC Settings: port 8000, OSC input enabled.
  → Make sure beyondHost in config.json matches Beyond's IP.

Bridge keeps reconnecting
  → Check internet connection on this machine.
  → The VPS relay must be reachable (outbound HTTPS port 443).

Status stays "Waiting for bridge..." in Conductor
  → Make sure start-bridge.bat is running.
  → Check that your firewall allows outbound HTTPS connections.
