##################################################################################################################
# ____   ____          ___.           __  .__   _____                                                            #
# \   \ /   /__________\_ |__ _____ _/  |_|__| /     \	    information - channel: #nolimits @ efnet             #
#  \   Y   // __ \_  __ \ __ \\__  \\   __\  |/  \ /  \                     email: wK@peaker.net                 #
#   \     /\  ___/|  | \/ \_\ \/ __ \|  | |  /    Y    \               website(s): http://vm.peaker.net          #
#    \___/  \___  >__|  |___  (____  /__| |__\____|__  /                      icq: 23177394                      #
#               \/          \/     \/                \/                                                          #
#                                                                                                                #
##################################################################################################################

[ R E A D M E ]

README - xmp3 v 2.0
xmp3 is an mp3 script for BitchX.

Requirements:
perl
mpg123
tclsh

Setup/Installation:
tar -xvf xmp3.1.0.tar
make sure it untars into ~/xmp3
add "load ~/xmp3/mp3.bx" to ~/.bitchxrc
start BitchX
do /mp3clean
do /mp3setup (see below) 

Commands:
/mp3clean - cleans your cache and mp3dirs.

/mp3setup <dir> - adds a new mp3dir and recursive-caches it.

/mp3 <mp3> - plays an mp3. supports wildcards, eg. /mp3 *astral*sound* would play "Astral Projection - Soundform.mp3". is
not case sensitive. is recursive - i.e., if you made your mp3dir /home/user/mp3, and Will_Smith-Willenium.mp3 was in
/home/user/mp3/willenium/, /mp3 *will*willen* would play it.

/rmp3 - /rmp3 *blah* will play a random mp3 from all mp3s matching *blah*, just /rmp3 will play any random mp3.

/mp3s - stop mp3. note, if you are stopping an /mp3r the mp3 will play out and then stop (no more random mp3s).

/mp3e - echo the mp3 (in the small chance that the script didnt)

/cache - cache all mp3s in your mp3 dir (recursive). use whenever you get a new mp3. 

/tcache <dir> - cache all mp3s in your usual mp3 dir AND all mp3s in <dir> (recursive).

/mp3r - random, continuous (it keeps the hits coming :P) mp3 play. -- THIS WORKS NOW, WHODAMAN@!*&^@*&^@