jstott.me.uk: 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.

Download

Current Version

v0.82 - 10th November 2005

choonbot-0.82.jar (58kB)
choonbot_skin-0.82.zip (6kB)

Previous Versions

v0.81 - 26th February 2004

choonbot-0.81.jar (60kB)
choonbot_skin-0.81.zip (6kB)

How to set up ChoonBot

First set up Winamp and then download and install BrowseAmp.
Download the ChoonBot skin for browseamp and unzip it to the browseamp folder in the winamp plugins folder (e.g. C:\Program Files\Winamp\Plugins\browseamp\).
Configure BrowseAmp to use the choonbot skin.
Assuming that choonbot.jar and Paul Mutton's pircbot.jar are in the current directory, run the following command:
```
java -cp pircbot.jar;choonbot.jar
     uk.me.jstott.choonbot.Main
     -n <botname>
     -s <server>
     -c <channel>
     -d <dcc_folder>
     -w <browseamp_server>
```
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.

Requirements

Java v1.4.2
Winamp v2.9 or v5.0
Browseamp v2.06
PircBot v1.2.8

Features

All the normal track control functions - play, pause, stop, next, previous.
Volume and balance control.
Display of currently playing track.
Let's users rank their favourite tunes and then to display a list of the top ranked tunes.
Searching of the current playlist by track, artist or album.
Control of the shuffle state.
Allows new tracks to be DCCed to ChoonBot which are then added to the playlist.

Version History

0.82 - 10th November 2005

Fixed BrowseAmp server switch -w bug.

0.81 - 26th February 2004

Added confirmation of the current volume when setting the volume.
Added the ability to set the URL of the BrowseAmp server through a new switch (-w).

0.8 - 12th February 2004

First version that really works, sort of!

ChoonBot Licensing

This software product is available under the GNU General Public License (GPL).