It is written in Java, so you will need to make sure that you have the Java JRE 1.5 or higher available from http://www.java.com. Being written in Java, it means that you can easily run the bot on a windows or a linux machine, or any machine with an operating system that has a JVM available for it. There are some clear instructions for Installing Java courtesy of http://www.jibble.org
AnnounceCaster allows relaying SHOUTcast song info messages to a number of different channels. It uses a main bot as a "hub" and then a number of relay bots that can be requested to join channels.
Features:
AnnounceCaster configuration is done with 3 files. The main config file is AnnounceCasterConfig.xml and this contains all of the IRC connection configuration, bot behaviour, outputs, and relay bots. The second configuration file is AnnounceCasterChannels.xml and this is a list of the channels that the relay bots are in (and will join when restarted). The third configuration file is AnnounceCasterAdverts.xml which has any fixed timed announcements/adverts in.
Command: !help
Description: Ask for some quick help info about the commands. You are only shown commands that your auth level allow.
Auth Level: none
Where to give command: channel
Outputs to: notice
Example(s):
Command: !request
Description: Asks for a relay bot to join a channel
Auth Level: none
Where to give command: channel
Outputs to: channel
Example(s):
Command: auth
Description: To auth, you need the adminPassword or trustedPassword set in the config file, and to use the name of the bot as it is when it is on IRC. This will mean that you are authed with the bot for as long as you are both in the same channel. If either you or the bot quits the channel, you will have to auth again.
Auth Level: none
Where to give command: private message
Outputs to: notice
Example(s):
Command: join
Description: Tells the bot to send a relay bot to a channel
Auth Level: trusted
Where to give command: private message
Outputs to: notice
Example(s):
Command: part
Description: Tells the bot to tell a relay bot to leave a channel
Auth Level: trusted
Where to give command: private message
Outputs to: notice
Example(s):
Command: !play
Description: Requests a song to be played (to a list that a DJ can manage)
Auth Level: none
Where to give command: channel
Outputs to: nowhere
Example(s):
Command: !playlist
Description: Lists the songs that have been requested
Auth Level: trusted
Where to give command: private message
Outputs to: DCC Chat
Example(s):
Command: !del
Description: Deletes a song from the request list
Auth Level: trusted
Where to give command: private message
Outputs to: private message
Example(s):
Command: !clear
Description: Clears all songs from the request list
Auth Level: trusted Where to give command: private message
Outputs to: private message
Example(s):
Command: !ignore
Description: Tells the bot to ignore a user
Auth Level: trusted
Where to give command: channel
Outputs to: notice
Example(s):
Command: !unignore
Description: Tells the bot to stop ignoring a user
Auth Level: trusted
Where to give command: channel
Outputs to: notice
Example(s):
Command: shout
Description: Sends a message through all relay bots
Auth Level: admin
Where to give command: private message
Outputs to: channel each relay bot is in
Example(s):
Command: reload
Description: Reloads the output section of the config file
Auth Level: admin
Where to give command: private message
Outputs to: notice
Example(s):
Command: restart
Description: Restart thje bot and all relay bots
Auth Level: admin
Where to give command: private message
Outputs to: bot quits and then rejoins
Example(s):
Command: die
Description: Kill / Quit / Stop the bot and all relay bots
Auth Level: admin
Where to give command: private message
Outputs to: bot quits
Example(s):
Adverts are managed in the AnnounceCasterAdverts.xml file. Any plain text editor can be used to edit this file. Adverts are simply messages that are repeated at fixed intervals which means you need 2 pieces of information ... the advert text and how often you want the bot to show this message in the channels that it (including all of the relay bots) are in. This will show the text "test message" every 30 seconds:
<advert message="test message" timer="30"/>
Last Updated Saturday, January 09 2010 @ 06:18 AM CST|8,533 Hits 
| Stats |
| Reg Users |