https://github.com/spotlightkid/osc2mqtt

An OSC to MQTT bridge based on pyliblo and paho-mqtt
https://github.com/spotlightkid/osc2mqtt

Last synced: 9 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/spotlightkid/osc2mqtt
• Owner: SpotlightKid
• License: mit
• Created: 2015-08-30T16:21:10.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2023-05-06T15:55:58.000Z (over 2 years ago)
• Last Synced: 2024-03-15T13:46:27.228Z (almost 2 years ago)
• Language: Python
• Homepage:
• Size: 31.3 KB
• Stars: 19
• Watchers: 5
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

          
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.

.. _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