Metadata-Version: 2.0
Name: osc2mqtt
Version: 0.2b2
Summary: An OSC to MQTT bridge based on pyliblo and paho-mqtt.
Home-page: https://github.com/SpotlightKid/osc2mqtt
Author: Christopher Arndt
Author-email: chris@chrisarndt.de
License: MIT License
Download-URL: https://github.com/SpotlightKid/osc2mqtt/releases
Keywords: osc mqtt iot
Platform: POSIX
Platform: Windows
Platform: MacOS X
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Manufacturing
Classifier: Intended Audience :: Other Audience
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Communications
Classifier: Topic :: Internet
Classifier: Topic :: Home Automation
Classifier: Topic :: Multimedia :: Sound/Audio
Requires-Dist: paho-mqtt
Requires-Dist: pyliblo

An OSC_ to MQTT_ bridge based on pyliblo_ and `paho-mqtt`_.

Quick Start
-----------

1. `pip install 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.

.. _osc: http://opensoundcontrol.org/
.. _mqtt: http://mqtt.org/
.. _paho-mqtt: https://www.eclipse.org/paho/clients/python/
.. _pyliblo: http://das.nasophon.de/pyliblo/
.. _osc2mqtt.ini: https://github.com/SpotlightKid/osc2mqtt/blob/master/osc2mqtt.ini

