ChoonBot

ChoonBot uses a combination of Winamp
(not version 3!), BrowseAmp and
Paul Mutton's PircBot
to create an IRC bot that allows users on an IRC channel to control the
music played by the computer that is running Winamp. BrowseAmp uses
HTTP requests to control Winamp, so in theory, Winamp and BrowseAmp
could be running on one computer and ChoonBot on another.

The current version is
0.82 (
10th November 2005 ).

ChoonBot is provided without warranty of any kind and use is
entirely at your own risk. As it is still in development, there may be
many problems still to be sorted out. E-mail me at choonbot@jstott.me.uk to
report any problems with ChoonBot.

where botname is the name of the bot, server
is the URL of the server to join, channel is the name of
the channel to join, dcc_folder is the absolute path name
to a local folder where ChoonBot can save DCCed music files (with a
trailing '/') and browseamp_server is the full URL to
BrowseAmp (e.g. http://127.0.0.1:8080).

Type help in the channel to see a list of commands
that ChoonBot can understand

ChoonBot commands

Here is a list of commands that ChoonBot understands:

help - Display the list of commands that ChoonBot understands.

current - Display the track name, album, artist, elapsed time and
track length of the currently playing track.

play - Start playing.

play <track|artist> - Find the specified track or artist and start playing it. If
more than one track is found, ChoonBot will display a list of the
results - enter play <n> to play the nth
result. If more results are found than can be displayed, you should
refine your search.

pause - Pause the currently playing track. If Winamp is already
paused, pause will unpause the current track.

stop - Stop the currently playing track.

next - Skip to the next track in the playlist.

previous - Skip to the previous track in the playlist.

incvolume - Increase the volume.

decvolume - Decrease the volume.

volume [0-100] - Set the volume. Specify a value from 0 through 100.

balance [-100-100] - Set the balance. Specify a value from -100 through 100.

choon - Indicate your appreciation of the currently playing track.

top [1-10] - Display the most appreciated tracks (those which people said
choon to. Specify a value from 1 through 10 to display
that many of the top tracks.

about - Display the current version number for ChoonBot.

stats - Display the stats (number of tracks, playlist length,
currently playing track, track recording info, current volume, current
balance, Winamp version number and BrowseAmp version number).

shuffle - Toggle the shuffle state.

tracks <string> - Display a list of tracks whose titles match all or part of string.
If more results are found than can be displayed, you should refine
your search string. To play any of the results, say play
<n> where n corresponds to the result
number.

tracksby <string> - Display a list of tracks where string matches
all or part of the artist for that track. If more results are found
than can be displayed, you should refine your search string. To play
any of the results, say play <n> where n
corresponds to the result number.

artists <string> - Display a list of artists where string matches
all or part of the artist name. If more results are found than can be
displayed, you should refine your search string. To play any of the
results, say play <n> where n
corresponds to the result number.

albums <string> - Display a list of albums where string matches
all or part of the album title. If more results are found than can be
displayed, you should refine your search string. To play any of the
results, say play <n> where n
corresponds to the result number.

albumsby <string> - Display a list of albums by a particular artist where string
matches all or part of the arists for that album. If more results are
found than can be displayed, you should refine your search string. To
list all the tracks in one of the albums found, say albumsby
<n> where n corresponds to the result
number. To play any of the results, say play <n>
where n corresponds to the result number.