GLASHCTL
=======================================================================
This is a simple applet for controlling the LASH Audio Session Handler.
When you run it it will appear as a small LASH icon in your "notification
area" or "system tray" (if your desktop manager is compatible with 
freedesktop.org's "System tray" standard, 
http://www.freedesktop.org/Standards/systemtray-spec). This is typically
somewhere in the panel in KDE or GNOME.


WMGLASHCTL
=======================================================================
wmglashctl is a WindowMaker-compatible dockapp. It works exactly like 
glashctl.


BUILDING IT
============================================================
To build this program you will need the following libraries:

 * libgtkmm (2.10.1 or newer)
 * liblash (0.5.1 or newer)

You will also need to have the LASH server, lashd, somewhere in your $PATH.
To build the program with the default configuration (install in /usr/local,
compile with -g -O2 etc), simply type 'make' in this directory. If you want to
change the configuration, use the configure script (run configure --help for
details). When you type 'make' a program called glashctl should be generated,
and when you type 'make install' it should be installed on your system.

You need to install it before you run it, otherwise it won't find the LASH
icon file and will not start.


USING IT
============================================================
To use the applet, simply run the program 'glashctl'. If you have a 
standards-compliant system tray on your desktop a small LASH icon (a
cardboard box with a soundwave on it) should appear there. It is probably 
insensitive (greyed out), unless you were already running lashd or have the
LASH_START_SERVER environment variable set to 1. If you right-click the icon 
a menu will pop up where you can choose to start lashd. When lashd has 
started the icon should become sensitive (show colours), and you will be 
able to restore audio sessions and make JACK connections, and when there is 
an active session, save it, close it, rename it or change its directory. You 
can also quit the applet from the popup menu.

The program 'wmglashctl' is exactly the same, except that its LASH icon will
appear in a WindowMaker compatible dock or in a separate window instead of
in the system tray.


NOTES
============================================================
The LASH icon was created by Thorsten Wilms for the LASH project
(http://lash.nongnu.org).

I know that the GNOME HIG discourages using the notification area for 
permanent icons and icons that have actions other than just opening a window
associated with them, but until there is a standard for writing normal panel
applets that work in both KDE and GNOME and in other window managers I'll do
it anyway.


Send bug reports and suggestions to Lars Luthman, lars.luthman@gmail.com
