		*** PODGUI 0.5 ***

PODGUI is a software for the Line 6 POD boxes, under Linux.
It needs amidi from ALSA driver for Linux (driver, lib and utils modules).
It needs Tcl/Tk too, version >= 8.3
So if you dont have ALSA nor Tcl/Tk, install them before using PODGUI.
Tcl/Tk is included in RedHat 9.0 CDs and many other distributions.
ALSA is included in FC1 (its the new Linux sound system since FC1)

PODGUI runs under Windows as well. This package is the Linux version.

PODGUI contains podgui.tcl 0.5, podlist.tcl 2.0, poddump.tcl 2.0 and l6t.tcl

Installation
------------
1- Copy the zip file under the folder of your choice
2- Unzip Here. It will create a sub-folder named "podgui-0.5"
3- Launch setup.sh either by the file manager or in a terminal shell.

The setup will check Alsa and Tcl/Tk, then if the good versions are found, it
will ask you for creating a Music menu and/or a shortcut on the desktop.

Before using
------------
1- Make sure you have Tcl/Tk: The command "wish" should work. The command
"whereis wish" gives you the wish version too (which is the Tcl/Tk
version)
2- Make sure you have ALSA and amidi. The command "amidi" should work and
gives you a short help. The command "amidi -V" gives you the amidi version
(which is the ALSA utils version too)
3- Before using PODGUI, make sure tha the POD is ON and connected with its two
midi cables to the soundcard. MIDI OUT plugged onto "POD MIDI IN" and MIDI IN
plugged onto "POD MIDI OUT".
4- If you have only one sound card, thats all.
If you have more than one sound card, you should check the podgui.ini file.
It contains the alsa path to the device. Though this file is generated by
podgui you may edit it. But the best way to choose the device is to use the
midi setup inside the podgui program.

Using
-----
podgui.tcl 0.5 :
	This graphical user interface program shows all the parameters of the
	POD box with the "real" values (in %, miliseconds, dB)
	Its look and feel comes from the PODMAN program written by Christopher
	Coutlee

	You can choose any patch number or the manual mode or the tuner mode.
	The window controls (scales and buttons) allow changing each parameter
	in real time.
	In order to save the parameters you may use the SAVE button onto
	the box or the "Save POD" item on the File menu.

	The changes made directly onto the POD box are not copied in real time 
	to the program window (will be done in the future). You need to use the
	"read POD" function in the file menu to refresh the window parameters.

	The program is able to save the patch name onto the POD with the
	"Change Name" button.
	It is able to save or restore the parameters to and from sysex files
	(File menu).

	About the colors:
	Some parameters are colored in green. This means that they can only
	be accessed via the MIDI interface (not via box knobs or buttons).
	The Wha switch in dark green is not readable by MIDI (nor by the box),
	only by the super Line6 Floor Board.
	The patch name in red is not accessible via the MIDI (real time)
	controls, only via sysex.

	To launch the podgui.tcl program:
		- Under a terminal, launch it like any command from
		any directory explicitly (giving the full path) or implicitly
		(by the PATH environment variable)
		ex: /root/pod/podgui.tcl
		- By file manager, use the shortcuts generated by the
		  setup.
		- By the menu, use the Music menu generated by the setup.
		
	Now you can import L6T patch files using the import menu item.
	The functionality is still basic. It reads patch data in the chosen file
	and updates the POD and the program User Interface. It doesn't show
	extra data like Style, Band, Guitarist, Pickup ... It doesn't manage
	bundle files yet. The default L6T directory is ./l6t.

poddump.tcl 2.0 :
	This command line program reads the POD parameters.
	It is used by podctl and podlist.
	You can use it to compare two patches like that:
	You must be in the program directory
	./poddump.tcl 1 > 1
	./poddump.tcl 2 > 2
	diff 1 2
	rm 1 2

podlist.tcl 2.0 :
	A command line program that lists the patch names and numbers along
	with the Amp Model.
	You can use it to make a listing with your printer to be used with your
	POD far from your home PC.
	You must be in the program directory in order to launch it


You can send me any comment or complain about podgui at the email address below.
Enjoy

Thanks:
Thanks to Christopher Coutlee for its Windows PODMAN program.
He helps me to understand the POD. I take the freedom to use the same
MMI structure for PODGUI. PODMAN.EXE runs under Wine/Linux (with ALSA).

Rub Cohen
rub0612@yahoo.fr
