
      ____             _            _       __  __    ____ _   _ ___ 
     | __ )  __ _  ___| |_ ___ _ __(_)_   _|  \/  |  / ___| | | |_ _|
     |  _ \ / _` |/ __| __/ _ \ '__| | | | | |\/| | | |  _| | | || | 
     | |_) | (_| | (__| ||  __/ |  | | |_| | |  | | | |_| | |_| || | 
     |____/ \__,_|\___|\__\___|_|  |_|\__,_|_|  |_|  \____|\___/|___|

                                -------------
                                 Version 0.2
                                -------------

About
=====

Bacterium_gui is a quick&dirty ncurses gui for creating and editing BacteriuM
config files. It's written by Clifford Wolf <http://www.clifford.at>.

BacteriuM is a non-realtime software synth written by Stefan Fendt. This
version of bacterium_gui is made for BacteriuM 0.2.99 config files. It may
or may not work with other versions of BacteriuM.

More information can be found at <http://members.ping.de/~stefan/>.

Installing
==========

Simply type 'make && make install' for building bacterium_gui and installing
it in /usr/local. Change the 'prefix' variable in the Makefile if you want to
install it in another prefix.

Bacterium_DSP Patch
===================
The file "bacterium_dsp.patch" is a unified diff-patch for BacteriuM 0.2.99
which alowes a DSP device to be the output file of BacteriuM. That way it's
possible to use BacteriuM to play sound in real-time (if your CPU is fast
enough). The "Play" Button in BacteriuM_GUI require this patch to be applied.

Running
=======

Start bacterium_gui with the *.synth (BacteriuM config file) as parameter.
Please do make backup copies of your *.synth files before editing them with
bacterium_gui, since bacterium_gui will drop all your comments in the *.synth
file and will ignore eveything else it can't parse (e.g. config file commands
introduced in BacteriuM versions past 0.2.99).

You can use your cursor-keys to navigate between the various data fields
configuring the synth. Press ENTER if you want to change the value in the
current field. The Buttons "Sample", "Play", "Help" and "Quit" can also be
reached with the shortcut-keys "s", "p", "h" and "q". All editing operations
will be written "just in time" back to the *.synth file. So there is no
extra save function.

Bacterium_gui and bacterium_ffd
===============================

If you are interested: bacterium_gui is a shell-script and it's using the C
program bacterium_ffd for displaying the user-interface. Bacterium_ffd might
become available as seperate package ffdialog (free form dialog) when it is
finished.

