File	Date	Author	Commit
icons	2013-03-20	Ad	[b74dd9] add icons
midi	2013-03-20	unknown	[db16fd] minor
soundfonts	2013-03-20	unknown	[db16fd] minor
win_stuff	2013-03-20	unknown	[9ee879] add win stuff: winpexpect
DEVELOP.txt	2013-05-13	Ad	[e07def] minor
README.txt	2013-05-13	Ad	[3ad6d1] minor
dialog_setup.py	2013-05-14	Ad	[aa488c] minor
gui__directories_dialog.py	2013-05-13	Ad	[2f27ca] minor
gui__directories_dialog.ui	2013-04-17	Ad	[22572f] major progression
gui__instrument_select_dialog.py	2013-05-13	Ad	[2f27ca] minor
gui__instrument_select_dialog.ui	2013-04-17	Ad	[22572f] major progression
gui__main_window.py	2013-05-13	Ad	[2f27ca] minor
gui__main_window.ui	2013-04-17	Ad	[22572f] major progression
gui__midifiles_dialog.py	2013-05-13	Ad	[2f27ca] minor
gui__midifiles_dialog.ui	2013-04-17	Ad	[22572f] major progression
gui__simple_textview_dialog.py	2013-05-13	Ad	[2f27ca] minor
gui__simple_textview_dialog.ui	2013-04-17	Ad	[22572f] major progression
gui__slider_dialog.py	2013-05-13	Ad	[2f27ca] minor
gui__slider_dialog.ui	2013-04-17	Ad	[22572f] major progression
gui__welcome_dialog.py	2013-05-13	Ad	[2f27ca] minor
gui__welcome_dialog.ui	2013-05-13	Ad	[2f27ca] minor
gui_handler.py	2013-05-14	Ad	[aa488c] minor
main.py	2013-04-17	Ad	[22572f] major progression
mk_gui.sh	2013-04-17	Ad	[22572f] major progression
util_2rumpf.py	2013-04-17	Ad	[22572f] major progression

Read Me

**********************************************************************
* About
**********************************************************************

  gmf_synth
  **********
  a GUI for Fluidsynth Soundfont Player and other Synthesizers



**********************************************************************
* Preparation
**********************************************************************


LINUX or UBUNTU operating system
-----------------------------------

# command line installation:
sudo apt-get install python python-qt4 fluidsynth alsa-utils qjackctl


install fluidsynth
install the jack-audio-server (jackd2 or jackdbus or jackd)
start   the jack-audio-server (for example with QJackCtl as GUI)

Fluidsynth - software synthesizer
-- https://sourceforge.net/apps/trac/fluidsynth/

Jack Audio
-- http://jackaudio.org/download

python language interpreter
-- prefered version: 2.7 (version 3.x will not work)
-- http://python.org/download/

pyqt4 -- python bindings for Trolltech(tm) QT Framework
-- http://www.riverbankcomputing.co.uk/software/pyqt/download

install pexpect package (if not available)
-- https://sourceforge.net/projects/pexpect/


required:
a midi-player usable from command-line: aplaymidi (in alsa-utils package)




Microsoft(tm) Windows compatible system
-------------------------------------------

not supported currently

which tool to use as midi-player is unknown
detailed use instructions are unknown


install fluidsynth
-- http://fluidsynth.flyx.org/
-- sources: http://sourceforge.net/projects/fluidsynth/?source=directory


install python
-- http://www.activestate.com/activepython/downloads


install PyQt4 - Qt4 bindings for python
note: select right installer for your python version and system
-- https://sourceforge.net/projects/pyqt/
-- http://www.riverbankcomputing.co.uk/software/pyqt/download


install setuptools for python
-- https://pypi.python.org/pypi/setuptools#windows


install winpexpect for python
-- https://bitbucket.org/geertj/winpexpect/wiki/Home


some helpful windows applications:
----------------------------------

Very useful command line midi tools
http://www.sreal.com/~div/midi-utilities/

Soundfont sf2 Editor: Polyphone - create your own sf2 from recorded samples
https://sourceforge.net/projects/polyphone/?source=dlp

Virtual MIDI Router
https://sourceforge.net/projects/midirouter/

Virtual Piano Keyboard
http://vmpk.sourceforge.net/

Virtual MIDI Port Connector (a midi bus): MIDI Maple 32bit
http://www.maplemidi.com/Maple_driver.html

Virtual MIDI driver : Rtp MIDI
http://www.tobias-erichsen.de/software/rtpmidi.html

Virtual MIDI Port : LoopBe1
http://nerds.de/en/loopbe1.html

Virtual MIDI Port : MIDI Yoke
http://www.midiox.com/


Brels Midi Sequencer
http://breno.sarmen.to/midi/

Aria Maestosa Sequencer
https://sourceforge.net/projects/ariamaestosa/?source=dlp

NoteWorthy Sequencer, Notation Tool
http://www.noteworthysoftware.com/


Apple(tm) Mac OsX compatible system
-------------------------------------------

not supported currently

which tool to use as midi-player is unknown
detailed use instructions are unknown







**********************************************************************
* Run it
**********************************************************************

1. start jack-audio-server (jackd or jackdbus)
   (for example: use QJackCtl as GUI)

2. start gmf_synth
   python main.py 

3. select audio and midi drivers
   or command-line for starting fluidsynth

4. on right side of gmf_synth click 'Choose Scanned Directories'
   select some directories with sf2 soundfonts and midi-files !

5. the soundfonts should appear in the right list.
   load one of the files into the synthesizer (click 'Load Selection')

6. play ! connect fluidsynth to your midi-sequencer, 
   play a midi file, select channel instruments, ...



**********************************************************************
* 
**********************************************************************
    
    Copyright (C) 2013 by Emanuel Rumpf
    Contact:  em-rumpf (at) gmx (.) de
    
    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation,  version 3 of the License.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.
    
    You should have received a copy of the GNU General Public License
    along with this program. If not, see <http://www.gnu.org/licenses/>
    

**********************************************************************
* 
**********************************************************************