README.rst

osc2mqtt

An OSC to MQTT bridge based on pyliblo and paho-mqtt.

Quick Start

1. pip install cython osc2mqtt
2. Get osc2mqtt.ini and edit the options section and set your MQTT broker host and port and, optionally, an OSC host and port as a reveiver.
3. Run osc2mqtt -v and start publishing MQTT messages or sending OSC messages to udp://localhost:9001/.
4. Watch debugging output for the MQTT topics, OSC addresses and the kind of MQTT message payload and OSC arguments the messages have.
5. Add conversion rules to osc2mqtt.ini as needed. The DEFAULT section has helpful comments. Also change the subscriptions option to only receive the MQTT messages you're interested in.
6. Quit osc2mqtt with Control-C and restart it to try out your new configuration. Repeat from step 4, if necessary.