mididings - a MIDI router/processor based on Python

Copyright (C) 2008-2014  Dominic Sacré  <dominic.sacre@gmx.de>

http://das.nasophon.de/mididings/

Note:
=====

This is a fork which, as of 2022-03-01, will compile and run well
in a most current Python3 environment.  The original web site, including
excellent practical documentation, has also been mirrored into the 
'www-pages' folder, since the author has not been heard from in 
quite some time.

2022-11-26: The fork of ponderworthy was remerged into this repository.

License:
========

mididings is released under the terms of the GNU General Public License,
version 2 or later.
The example scripts in doc/examples are in the public domain.


Requirements:
=============

* Python 3 current [http://www.python.org/]
* ALSA [http://www.alsa-project.org/]
* JACK (>= 0.116.0) [http://jackaudio.org/]
* Boost (Boost.Python, Boost.Thread) [http://www.boost.org/]
* Glib [http://library.gnome.org/devel/glib/]
* decorator [http://pypi.python.org/pypi/decorator]

Optional:
=========

* pyliblo [http://das.nasophon.de/pyliblo/]
  (to send or receive OSC messages)
* pysmf [http://das.nasophon.de/pysmf/]
  (to read/write standard MIDI files using the process_file() function)
* dbus-python [http://dbus.freedesktop.org/releases/dbus-python/]
  (to send DBUS messages)
* pyinotify >= 0.8 [https://github.com/seb-m/pyinotify]
  (to automatically restart when a script changes)
* Tkinter
  (for the livedings GUI)
* pyxdg [http://freedesktop.org/wiki/Software/pyxdg/]
  (so mididings knows where to look for config files)


For example on debian/ubuntu install following packages:

sudo apt install -y\
   libglib2.0-dev\
   libjack-jackd2-dev\
   libboost-python-dev\
   libboost-thread-dev

and python3 packages:

sudo apt install -y\
    python3-liblo\
    python3-dbus\
    python3-decorator\
    python3-pyinotify\
    python3-tk


Build:
=============

By default both alsa and jack backends included in the build.
Update config variable in the setup.py to cutomize.

python3 -m build

Installation:
=============

sudo pip install dist/mididings-*.whl

Documentation:
==============

See http://dsacre.github.io/mididings/doc/ for the mididings manual.