forked from rralf/mididings
-
Notifications
You must be signed in to change notification settings - Fork 3
/
README
87 lines (62 loc) · 2.16 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
mididings - a MIDI router/processor based on Python
Copyright (C) 2008-2014 Dominic Sacré <[email protected]>
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.