This is GLAME 1.0.3 - GNU/Linux Audio Mechanics stable release.

GLAME is meant to be the GIMP of audio processing. It is designed to be
a powerful, fast, stable, and easily extensible sound editor for Linux
and compatible systems. Supported platforms are Linux, BSD and IRIX.

Authors in chronological order
	mag, XWolf, richi, nold, navratil
with their real names
	Alexander Ehlert,
	Johannes Hirche,
	Richard Guenther,
	Daniel Kobras,
	Joe Navratil

CVS, mailinglist and homepage are hosted by sourceforge. Have a look at
http://glame.sourceforge.net/ or http://www.glame.de/

For end user discussion and sharing of tips and tricks regarding the use of
GLAME, join the mailing list <glame-users@lists.sourceforge.net>.
Subscription information can be found at 
http://lists.sourceforge.net/mailman/listinfo/glame-users

Tuebingen October 28th, 2004


Quick Start for the impatient
=============================
If you got a glame tarball just do the usual
> ./configure && make && make install
and you will get the programs 'glame' and 'cglame' installed.

If you checked out the glame cvs first do
> ./autogen.sh
If you do not want to install glame, you can find 'glame' in
'src/gui/glame' and 'cglame' in 'src/cglame'.

There is a command line interface to glame (with some extended
features and with some features missing) called 'cglame'. You will end
in a scheme shell after launching cglame and have access to the
backends and the midlayer API. Look into src/glmid/glame.scm for some
example scheme code.

With the GUI 'glame' you are provided with a full featured filter network
editor that allows you to create custom effects and to do realtime
processing. Also viewing and editing (cut & paste and applying effects)
of waves is supported. Basic sequencing of waves is supported via the
preliminary timeline.

Want more? Then join our devel team at SourceForge! An e-mail to
glame-devel@lists.sourceforge.net will get you going.

You want to contribute? Please join our mailinglist (see above) and ask
for a task. If you just want to write some filters a start is the excellent
filter API documentation in doc/ and of course many existing filters whose
source can be found in the src/plugins directory.


Requirements
============
- Supported platforms so far are Linux, IRIX6.5 and BSD, we occasionally try
  to make it compile on Solaris, AIX and HP-UX. Supported (tested)
  architectures are Intel x86 compatible, PowerPC and MIPS (IRIX only).
  On all platforms gcc is required to compile GLAME, using version
  2.95.2 or later is highly recommended.
- You may need glibc2.x on Linux, other versions were not tested.
- For the GUI part, it's best to try with recent versions of the
  Gtk+ and GNOME libs (those from the gnome distributions starting at
  version 1.4 should suffice).
  With most distributions GNOME requires an ancient version of libdb.
  Be sure to install its development package or you will get linking
  failures complaining about missing -ldb1 or such.
  Note that Gtk+-2.0 and GNOME-2.0 or later are not supported in this release.
  configure --disable-gui is your friend...
- The scripting part makes use of guile; upgrading to the lastest and 
  greatest here is a good idea too, in case anything doesn't work as 
  expected (latest 1.4 and latest 1.6 releases are known to work).
- Another requirement is a recent libxml which is used by the midlayer.
- For developing you need autoconf version 2.5 or later and automake
  of the 1.6 series as well as recent libtool and gettext at least
  version 0.11.3.
- For full-featured I/O to files a recent version of libaudiofile is
  needed (at least 0.2.2 is required for libaudiofile support to be
  included).
- To enable Mp3 and Ogg importing support you need to have libmad and
  libvorbisfile of at least version 1.0 installed.
- For full-featured I/O to your soundcard use ALSA version 0.9, though
  OSS may suffice, too.
- Glame uses Gnome1 at the moment, Gnome2 users may read the BUGS file
  and search for workarounds for some problems there.


Current Status (as of version 1.0.3):
=====================================
- usable GUI - src/gui/glame
  * wave editor
  * filter network editor for customizing filters
- usable console UI - src/cglame
  * scripting of GLAME via the Scheme language
- user and development documentation
- on-line help
- the glame midlayer which supports
  * plugins
  * scripting (using guile)
  * hierarchical organization and processing of wave data
- the filternetwork backend which supports
  * threading, i.e. pipelined processing of all data
  * feedback inside the network does work
  * zero-copy operation inside and between filters
  * realtime parameter updates
- the swapfile backing store


Thats all folks!

	Yours, GLAME-Team.

