• Téléchargez la dernière version disponible ici

• Extrayez l'archive dans un répertoire ou vous avez les droits d'écriture (généralement /home/votre_nom_d'utilisateur/src/mididings/)

• Vérifiez que vous avez les dépendances requises, et dans le cas contraire, installez les.
  Les dépendances obligatoires sont :
  • Python >= 2.5
  • Boost >= 1.34.1 (contenant Boost.Python, Boost.Thread)
  • Glib
  • Alsa
  • jack >= 0.116.0
  
  Il existe aussi des dépendances facultatives, qui permettent de rajouter des fonctionnalités à mididings. Celles-ci sont :
  • pour envoyer et recevoir des messages OSC : pyliblo
  • pour envoyer et recevoir des messages D-Bus : dbus-python
  • pour mettre à jour automatiquement les changements dans vos scripts : pyinotify >= 0.8
  • pour utiliser l'interface livedings : Tkinter
    utilisateurs de gentoo : Tkinter fait partie du paquet python, mais n'est pas activé par défaut. Il vous faudra rajouter le USEFLAG "tk" à votre système et recompiler python (emerge --newuse python). Pour plus d'infos sur les useflags, reportez-vous à ce paragraphe de la page dédiée à gentoo
  • Pour lire/écrire des fichiers MIDI en utilisant la fonction process_file() : libsmf

• allez dans le répertoire de Mididings

  cd mididings-le_numero_de_version

• Compilez Mididings grâce au programme setup.py inclus
  Il existe trois options de compilation que vous pourrez rajouter à la fin de la commande suivante :
  • --disable-jack-midi : par defaut jack-midi est activé, cette option sert à le supprimer
  • --disable-alsa-seq : pareil pour alsa-midi
  • --enable-smf : par défaut lire et écrire des fichiers MIDI est impossible, activez cette fonction si vous le souhaitez
  
  
  compilation

  ./setup.py build

• Installez Mididings en root

  pour ubuntu : 
  sudo ./setup.py install 
  pour le reste : 
  su 
  ./setup.py install

• doc/examples/print.py

• a venir...

• doc/examples/aeolus.py

• doc/examples/output.py

# ce patch permet d'utiliser deux instances de yoshimi connectées sur le même
# port MIDI sans avoir à refaire les branchements à chaque fois. En entrée, il
# utilise les "changements de programme" (PC) sur le canal 15
# pour passer d'un canal à l'autre sur l'une ou l'autre des instances du synthétiseur

# Il assume que yoshimi est démarré par deux fois avec l'option -a (alsa_midi)
# http://yoshimi.sourceforge.net/

# pianolivier chez gmail point com

from mididings import *

config(
    # utilise alsa_midi
    backend='alsa',
    # nom du client alsa_midi
    client_name='yoshiswitch',
    # nom du port d'entrée
    in_ports = ['in'],
    # noms des deux ports de sortie
    out_ports = ['out1', 'out2'],
    # reçoit des données MIDI de 1 à 128
    data_offset = 1,
)

# la fonction output() renvoie les données reçues sur le port / canal spécifié
# cette liste correspond aux réglages effectué dans yoshimi, par exemple :
# dans la première instance du synthétiseur, un son de vibraphone est chargé
# sur le canal 1, un son de xylophone est chargé sur le canal 2, et ainsi de suite...
# chaque ligne est une fonction python et doit commencer par un nom unique

# port "out1", canaux 1 à 16
vibra		        = Output('out1', 1)
xylo		        = Output('out1', 2)
tremlead	        = Output('out1', 3)
fantasia	        = Output('out1', 4)
fullstring	        = Output('out1', 5)
slowsring	        = Output('out1', 6)
multisynth	        = Output('out1', 7)
fretlessbass	= Output('out1', 8)
steelbass	        = Output('out1', 9)
distobass	        = Output('out1', 10)
greatorgan	        = Output('out1', 11)
sines		        = Output('out1', 12)
sweepmatrix	= Output('out1', 13)
sweeppad	        = Output('out1', 14)
brightrushpipe	= Output('out1', 15)
echochoir	        = Output('out1', 16)

# instruments définis dans la 2eme instance de yoshimi
# port "out2", canaux 1 à 16
slowmorphchoir	= Output('out2', 1)
seq1		        = Output('out2', 2)
seq2		        = Output('out2', 3)
arpeggio1	        = Output('out2', 4)
sharpdeep	        = Output('out2', 5)
farreed		= Output('out2', 6)
bassoon		= Output('out2', 7)
eeoow		= Output('out2', 8)
yaooww		= Output('out2', 9)
overdrive1	        = Output('out2', 10)
overdrive2	        = Output('out2', 11)
overdrive3	        = Output('out2', 12)
powerguitar1	= Output('out2', 13)
powerguitar2	= Output('out2', 14)
panpipe32	        = Output('out2', 15)
hypermatrix	= Output('out2', 16)

run(
    # scènes numérotées de 97 à 128 correspondant à des PC de 96 à 127
    # chaque scène ici renvoi à une des fonctions définie plus haut
    scenes = {
        97: vibra,
	98: xylo,
	99: tremlead,
	100: fantasia,
	101: fullstring,
	102: slowsring,
	103: multisynth,
	104: fretlessbass,
	105: steelbass,
	106: distobass,
	107: greatorgan,
	108: sines,
	109: sweepmatrix,
	110: sweeppad,
	111: brightrushpipe,
	112: echochoir,
	113: slowmorphchoir,
	114: seq1,
	115: seq2,
	116: arpeggio1,
	117: sharpdeep,
	118: farreed,
	119: bassoon,
	120: eeoow,
	121: yaooww,
	122: overdrive1,
	123: overdrive2,
	124: overdrive3,
	125: powerguitar1,
	126: powerguitar2,
	127: panpipe32,
	128: hypermatrix,
    },

    # passage d'une scène à l'autre : utilise les PC sur le canal 15
    control = Filter(PROGRAM) >> ChannelFilter(15) >> SceneSwitch(),

    # pré-traitement des données envoyées aux synthétiseurs :
    # ignore les messages en dehors du canal 1 et les PC
    pre = ChannelFilter(15) >> ~Filter(PROGRAM),
)

• doc/examples/klick.py

• doc/examples/hooks.py