"ShoutCast status" (Scs) is a script compatible for mIRC which returns specific information about the status of a [Nullsoft ShoutCAST D.N.A] server.Please read [www.shoutcast.com] for more information about how the server works itself.
[1.0.0] Introduction |
Ok, lets start with the introduction. ShoutCast status is a script which connects to the specified shoutcast-server through a socket. It connects and once it's connected; It will retreive information off the server and display it in the channel(s) you would like in any certain way you like thus it's fully-cusomtizable and yet easy to use and setup.
I hope you like this script and I hope it's of good use. If you have any problems setting ShoutCast status up then please read the documenation further for gaining more knowledge about this script.
Please continue reading for detailed explanation about each of the setting items.
As I have said before; Didie is the name of the bot which connects through a socket and displays the ShoutCAST status in any way you like to have it displayed.
IRC: <server where the bot is going to connect to> : <port>
Nick: <nickname of Didie>
Anick: <nickname that Didie will use if the primairy nickname is in use>
Name: <name of Didie>
Version: <The Client-to-Client protocol(CTCP) version reply>
Chan: <the channel where Didie will show it's status and where Didie will join>
"Use current loaded mIRC client"
If you check this then Didie will be disabled and your current nickname will be used.
"Use 'Didie' (socket)
If you check this then Didie will be used and not your current nickname.
Please make sure that you fill in all editboxes and do not leave any blank. This might give problems to the script.
Use trigger to show information
If you enable this feature, then the specified trigger will be used to show information in the trigger channel.
Use timer to show information
If you check this checkbox, then a timer will be used to display the status to all specified channels. You can also specify the Delay, which is in seconds. As you can see above; I specified "60" which means it will display the status every 60 seconds. You can change this delay to any number you like to.
Status
In this editbox you can specify how you want it to be messaged. You can use mIRC's color charachters and bold/underline charachters too. The script will replace these strings with it's value:
[nick] Nickname who requested the trigger
[me] Current nickname of the bot
[channel] Channel where the trigger got triggered
[time] Returns time in "hh:mm:ss" format
[globaltime] Returns time in 'DDD MMM dd hh:mm:ss YYYY" format
[timestamp] Returns mIRC's $timestamp
[addr] Returns the full address of the nickname
[lis] Returns the amount of listening clients on the ShoutCAST server
[peak] Returns the peak of listeners on the ShoutCAST server
[max] Returns the amount of max users your server can handle
[un] Returns the ammount of unique listeners
[bit] Returns the bitrate
[song] Returns the songname
No SHOUTcast
This message will be displayed if the ShoutCAST server could not be reached. This could be because there isnt a ShoutCAST server running on the specified host:port, or because there couldnt be a connection made to the server.
Usable variables for this editbox are:
[nick]: Nickname who requested the trigger
[me]: Current nickname of the bot
[channel]: Channel where the trigger got triggered
[time]: Returns time in "hh:mm:ss" format
[globaltime]: Returns time in 'DDD MMM dd hh:mm:ss YYYY" format
[timestamp]: Returns mIRC's $timestamp
[addr]: Returns the full address of the nickname
No Stream
This will be messaged if no one is streaming audio to the ShoutCAST server which means that the server itself is running, but it is not in use.
Usable variables: Same as for No SHOUTcast
This is the part where you need to specify the ShoutCAST host/ip and the port.
Address: The host/ip where the script will connect to
Port: the port of the host/ip where ShoutCAST is running on
I guess I said enough ;)
User-agent: This is the user-agent that will be sent through the socket as identification part.
Current User-agent: The user-agent wich is currently going to be used and thus specified.
Website: www.vegetasan.net
Date: 2006/26/02
Thanks to Nullsoft
/ End of documentation