
MP3Shell v1.2.20
----------------

MP3Shell is a simple Tcl/Tk GUI for the mpg123 MP3 player.
The latest version of mpg123 can be found at http://www.mpg123.com.
You need Tcl/Tk version 8.3 or higher to run this program.
For installation instructions, see 'INSTALL'.


Short description of commands
-----------------------------

Play	Play an MP3 file or playlist 	keyboard shortcut: p
Stop	Stop play 			keyboard shortcut: s
Pause	Pause play 			keyboard shortcut: <Space>
PList	Edit playlist 			keyboard shortcut: l
Quit	Exit program 			keyboard shortcut: q

Shfl	If playing from a playlist, shuffle the entries before playback.
Loop	Plays an MP3 file or playlist in an endless loop.
Mute	Mute/unmute the audio output.


Additional keyboard-only commands
---------------------------------

Left arrow 	Rewind 512 frames
Right arrow 	Fast forward 512 frames
Home		Play from the beginning of the current file.



How to use the playlist window
-------------------------------

The upper sub-window shows a directory listing, while the lower one
shows the current playlist.
To add a file to the playlist, double-click on a file name in the 
directory window, or press <Return>.
To remove a file from the playlist, double-click on the name in the
playlist window, or press <Delete>.

You can merge existing playlists with the current playlist by
selecting a playlist (*.m3u) file in the directory window.
The file names contained in the "source" playlist will then be added
to the current playlist.

To toggle between the directory and playlist window, press <Tab>.

To clear the playlist, press the "Clear" button or hit 'c'.
To save the playlist, press the "Save" button or hit 's'.

---------------------------------------------------------------------


NOTE: The somewhat slow response times of certain actions (such as
when loading a new song, stopping playback or fast forwarding) is a
consequence of mpg123 using an intermediate audio buffer (default size
1024 kb, about 6 seconds of audio data at 44100 Hz/128 bits/stereo) to
avoid interruption of the audio playback during periods of increased
system activity.  You can minimize the delays by setting the buffer
size to a smaller value, but this will also increase the possibility
of interrupted playback, with "choppy" sound as a result.  Experiment
with the buffer size value to find out what works best on your
particular system.


If any problem occurs, don't hesitate to write me.
My E-mail address is <mats_peterson@swipnet.se>

Good Luck!
