Metadata-Version: 2.0
Name: quatorzeheures
Version: 0.1.2
Summary: A Midi to OSC gateway
Home-page: http://github.com/philpep/quatorzeheures
Author: Philippe Pepiot
Author-email: phil@philpep.org
License: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5

Quatorze Heures
===============

.. image:: https://travis-ci.org/philpep/quatorzeheures.svg?branch=master
   :target: https://travis-ci.org/philpep/quatorzeheures
   :alt: Build status


A mono-directional `MIDI <https://en.wikipedia.org/wiki/MIDI>`_ to `OSC
<http://opensoundcontrol.org>`_ gateway.

Dump all midi sources using `amidi <http://alsa.opensrc.org/Amidi>`_ (require
the ``alsa-utils`` package) send MIDI bytes as an OSC udp stream
``/midi/<device> <midi bytes>``.


Features:

  * Generate a single OSC stream from multiple MIDI sources
  * Handle live new connections and disconnections of MIDI sources

Example::


    $ quatorzeheures 192.168.1.42:1214
    2016-08-12 02:47:44,653 stream OSC to udp://192.168.1.42:1214
    2016-08-12 02:47:44,662 connect Akai MPD18 MIDI 1 on port hw:2
    2016-08-12 02:47:49,223 Akai MPD18 MIDI 1 [176, 7, 37] --> '/midi/Akai_MPD18_MIDI_1\x00,iii\x00\x00\x00\x00\x00\xb0\x00\x00\x00\x07\x00\x00\x00%'
    2016-08-12 02:47:49,223 Akai MPD18 MIDI 1 [144, 10, 32] --> '/midi/Akai_MPD18_MIDI_1\x00,iii\x00\x00\x00\x00\x00\x90\x00\x00\x00\n\x00\x00\x00 '


Use with puredata
-----------------

`Download patch </examples/osc.pd?raw=true>`_.

.. image:: /examples/pd.png?raw=true

Installation
------------

Debian jessie package
~~~~~~~~~~~~~~~~~~~~~

Debian packaging is done in the `debian/unstable branch
<https://github.com/philpep/quatorzeheures/tree/debian/unstable>`_ and
available in my jessie-backports repository (for i386, amd64 and armhf
architectures)::

    wget -q -O - https://apt.philpep.org/951808A4.asc | sudo apt-key add -
    echo "deb http://apt.philpep.org jessie-backports main" | sudo tee /etc/apt/sources.list.d/philpep.list
    sudo apt-get update

    sudo apt-get install quatorzeheures


The package come with a systemd service ``quatorzeheures`` enabled, target host
can be customized in ``/etc/default/quatorzeheures``.


pip
~~~

::

    pip install quatorzeheures



