Chapter 3. The configuration file
In order to ensure a proper running, you need a configuration file named .pymprovisator.conf in your home directory. If you use the graphical interface mode, you can setup your configuration using the menu Song > Preferences or the button:
If you use the command line version, you have two options.
The first and easiest one: running the program with the option -s:
python pymprovisator.py -sThis command will create in your HOME directory a configuration file that you have to edit and adjust to your system (see below).
Second, more difficult way: Copy the sample configuration file provided in the directory pymprovisator/examples/ to your HOME directory with this command:
cp pymprovisator/examples/pymprovisator.conf.example ~/.pymprovisator.confOnce created your configuration file, you'll have to edit and adjust it to your preferences. Don't erase any line: the program would not run properly:
[PREFERED_INSTRUMENTS] bass = Acoustic Bass piano = Percussive Organ [PREFERED_VOLUME] drums = 90 bass = 90 piano = 90 [PATHS] midiplayer = /usr/bin/timidity -ig abc2midi = /home/david/myprograms/pymprovisator/exes/linux/abc2midi
In [PREFERED_INSTRUMENTS] section, you have to write the full name as listed below (Section 3.2).
In [PREFERED_VOLUME] section,you have to write an integer numerical value between 0 and 128.
Finally, en [PATHS] section you have to write the full path to your auxiliary programs ( abc2midi and a MIDI player). Remember: there are some precompiled versions of abc2midi in the directory pymprovisator/exes. Look at this directory before download anything. The abcMIDI's page is in (http://abc.sourceforge.net/abcMIDI ). You can download abc2midi from this location.
3.1. Note for Windows users who will use the source code version
In the Windows operating system there isn't HOME directory. There's something similar, but it's not the same. In home-user targeted Windows versions, like 95, 98 and Me, the HOME concept doesn't exists. Pymprovisator will look for your configuration file in some location. On Windows 9x/Me it will look in C:\, on Windows NT, in C:\WINNT\Profiles and on Windows 2000 it will look in C:\Documents and Settings
Since these locations may be overridden or different, the safest procedure is executing the program for the first time with the option -s. This will create somewhere in your hard drive a file called .pymprovisator.conf. Just execute:
python pymprovisator.py -s(You should have the Python interpreter in your PATH).Once you've done this, look for the configuration file and edit it.