Radio Toolbox
Radio Toolbox
Radio Toolbox Unlimited Shoutcast Listeners
Radio Toolbox
Menu
Search
Page Options
Sponsors
  
Radio Toolbox FAQ
   

Top What is Radio Toolbox?

Radio ToolBox is an application designed to give you an overall
image of your station's progress and status.  Features either
include or will include 

1) Ability to accumulate listener count data over a period of time
   with a set interval of checking the stat of a server given in
   the list.

2) Ability to accumulate data on Song popularity.

3) Ability to remotely administrate the application from a
   web-browser interface.

4) Ability to gather then parse stats of a network of servers.

5) (USS) Universal Server Support System, what this means is it
   will essentially be able to identify any server which uses
   the HTTP Protocal and follows the HTTP/1.0 specs.  This does
   not mean, however, that is supports all servers.

6) Current Server Support includes:
      - SHOUTcast
      - Steamcast
      - Icecast 2


7) Graphing data in a human readiable way over the period of a
   day using the ALPH system.  More on ALPH is available here:
   http://www.radiotoolbox.com/docs/faq/alph.php

8) Ranking songs in order of most heard.

9) (UWS) Universal Web-Interface Service, this is essentially a
   service built into the application to interface with any
   webserver which supports the FORM POST method of sending data
   into the server to be stored on a database, or static file.
   Examples of use are showing what's playing, showing the status
   of your servers, or showing the amount of users listening to
   your servers on a website.

10) (FIS) FTP Interface Service, use FTP to put the Current song,
    Listener count or a History of the last songs played on a
    webserver with a simple template file, this is the best
    option for those who are not yet comfortable with working
    with a scripting language and UWS.

11) Log Breakout, this feature breaks the log file up by days
    rather then one big log file.  This will give your daily log
    files the name of MM_DD_YYYY_rtb_log.txt for truely unique
    file names and easier browsing.

12) Current Stats Window, a seperate window to show you
    everything that is going on within Radio ToolBox including
    Network Consumption, Listener Count, Time online and TTSL.

13) Hot-Keys, for quick action on a Radio ToolBox function
    (ALT + C) opens the Current Stats Window.  (CTRL + J) About
    Box plus a complete list of Hot Keys.

The feature list is never closed and can and will continue to grow.


Top How can I contribute ideas to Radio ToolBox's development?

You can contribute by using our the Radio ToolBox Support forum
available at:
http://forums.radiotoolbox.com/viewforum.php?f=2

or you can post your idea in the discussion list available by 
emailing radiotoolbox-subscribe@radiotoolbox.com

If your idea is good enough it just might be added. :)


Top Is Radio ToolBox Freeware?

No, Radio ToolBox is not Freeware, it is going to be Authware
(I made this name up because I couldn't find a better description). 
Authware means that you must be authorized to use it by a
centralized server/service.  The terms of this authorization will
be written fully soon and added to the installation of the program.

Under this unique licensing system we will offer teired solutions,
while we haven't finalized this side of Radio ToolBox we have a
few drafted solutions.

1) Free solution - You download the application and sign up for the
   site under our free solution and you will be able to use a
   limited version of the application

2) Subscription Solution - You pay a monthly fee for radio toolbox
   and you get a full version of radiotoolbox and a log management
   system available at www.radiotoolbox.com.  This plan will be more
   detailed when we release.

3) Pay Once Solution - You pay a one time fee for the application
   and it's yours as a full version, there will be no log management
   system at radiotoolbox.com and the application will not bother
   communicating with radiotoolbox.com

These are just a few options, and I am sure they will change as we
get closer to rolling out the service.


Top I had SCDC when you guys were known as ShoutClub, and after the site was shutdown the application no longer worked, will I be able to rely on Radio ToolBox even if you guys shutdown at a later date?

Yes, Radio ToolBox (unlike SCDC) works on it's own without 
the need for a centralized server for information.  This is why 
SCDC no longer works, because it required information about 
your stream from a remote location, Radio ToolBox gets it's 
information from within your own file system.  So if for whatever 
reason we discontinue the project the application can be quickly 
converted to run independently. If or when this happens it is our
intention to make Radio ToolBox completely freeware.


Top Does Radio ToolBox communicate information about my stream with third parties?

No, Radio ToolBox only communicates with our server and this
information is held privately.  You will be able to optionally give
out accounts to other users to use the logged information.  This is
good for advertising purposes or showing others involved with your
webcast the log.

NO information is shared with anyone outside of the Radio ToolBox
team.


Top I saw your sig at the bottom of a forum post you made, did you use Radio ToolBox to make that?

Radio ToolBox did not generate that image, a script using the
information gather by the catcher script did.  This was designed
to help you see the true power of Radio Toolbox's backend and
PHP.  If you would like the script just go to:
http://www.radiotoolbox.com/codebed/radiotoolbox/whatimplayin.phps

You will need the image at:
http://www.radiotoolbox.com/codebed/radiotoolbox/songband1.png
to see it work, but you can make your own image of course.

Also your php installation will have to have the GD Library installed
read:
http://www.php.net/manual/en/ref.image.php for more information


Top Is it true that Radio ToolBox is a Webserver?

Yes, Radio ToolBox has a server built into it.  If you do not wish to
utilize this feature, you must set the Web Admin Port to 0, this is
available in the options screen.  Otherwise the default port is 4000
so yourip:4000 will bring up the webadmin screen.

By default the web interface is completely locked down requiring
you to login in order to recieve any document.  You can also
allow access to certain non-administrative pages, this way you
can take advantage of the load balancing listen.pls playlist.
This playlist will give your listeners a list of your servers order
from lowest percentage load to highest percentage load, effectively
creating a load balanced stream system (as long as you link to this
playlist from your website or other locations that might require
a link.

There is also a last 20 played list, a read only display of your servers
as they are in radio toolbox.

Write access or the administrative panel allowing you to edit or change
Radio Toolbox settings will always require login.

This feature can also be restricted to a certain amount of concurrent
users, thereby reducing abuse of this system.

Also there are some easter eggs hidden in the web admin panel
if you are up to the challenge see if you can find all of them :)


Top How do I report a problem I am having with Radio ToolBox?

The best way to report a problem with Radio ToolBox is to use our
bugs system located at www.radiotoolbox.com/bugs/

Be as specific as possible when asking questions or making comments.
I am a programmer not a psychic so events that cause the problem are
a must otherwise it is almost impossible to track down.  I work
through bugs by trying to duplicate the situation that caused the
event.  Be sure to report any errors in the Current Stats screen or
give me data that is being generated by RTB.


Top Can I email you my problem or question or comments?

Bugs and questions should be restricted to the forum or discussion list,
the reason for this is quite simple.  Something that helped you will
most assuredly help someone else.

Comments are always welcome, negetive or positive, but please be
realistic :)  I always like to see how my programs are being utilized
so please include a link to your playlist page or whatever page you
are using RTB to generate.


Top When I use Radio Toolbox it complains about authentication failing, what do I do to fix this?

The status display at the bottom of the Radio Toolbox Dialog window is
for the Log Service only, except when you get the '!' exclamation
error that a service has failed.  The log service is basically the
service you sign up for at http://log.radiotoolbox.com/  If you did
not sign up for this service then you should signify that you do not
have an account in the General Page of the Options Dialog by
unchecking "I have a log service account".  Subsequent messages
will come in the form of "Log Service Touched (No Service)" which
is normal for those who do not participate in the service.
Participation in the service is not required and will not effect the
Script service or the FTP service parts of Radio Toolbox.


Top I use (your favorite OS here), will there be versions for this platform?

This all depends on the availability of the OS to us, if we can
write for it and how much it costs for us to develop the application
on that system.  This project is not funded so resources are slim.

Our intention is to work with the following platforms:
  - Windows Win32 and NT systems (Win95, Win98, WinME, Win2000,
    WinXP)

  - *nix (Mandrake OS glibc 2.2)

Windows at the moment takes precedence in development time over
Linux due to time constraints and for simplicity.

More OS's will be added to the list as they come available.


Top Why are you so crazy about putting copyright notices in your protocols and services?

Well this is for credit for doing work for you for free, PRO RTB
Licenses will not require Copyright notices.


Top When can we expect RTB version XXX to be Released?

The fact is that that is the worst question to ask a quality
programmer. There are alot of variables in programming that could
cause problems and delay finalization of a version or service.  So
it will be released when it is released.


Top Can I run the public beta available at the site?

Yes, you may run them and do whatever you like, but be aware that
drastic changes could happen to the interface, services, or
templating system.  This may or may not have side effects in
production use.  While I hold my programs to the highest of quality
standards, and try to make them as effeciently as possible in a
long-term situation, there could arrise situation in beta testing
that a particular function in RTB might not work or cause the
program to do unexpected things.  Under the most extreme conditions
the program could crash your entire system.  This is why it is in
beta testing.


Top Why does it seem to take longer for it to check certain servers stats?

This could be for a multitude of reasons including:

1) the remote server is simply busy with other transactions at the
   moment and cannot respond to RTB in a timely manner.
2) your internet or LAN connection is tied up or offline.
3) Side effect - Due to the nature of the server we are interacting
   with the application could lag in order to avoid being counted
   with the statistics of the server.  (this is very true with
   Live365 servers)
4) low ping times (lag) between you and the server.


Top Does RTB support the new Dynamic IP system at Live365? and does it support Live365 mount points and redirection.

As of Beta 1c RTB has the ability to navigate the Live365 system and
gather stats.  You may use the www.live365.com/play/##### URL format
in the application to have an always true IP for the server on their
system.  to add this value simply click the Add button.
For server enter 'www.live365.com' w/o quotes, enter port '80' w/o
quotes, and enter /play/##### as the Mount.

Where #### is your Stream ID this is usually a 5 digit number.

This capability was actually added prior to beta 1c because of
Icecast 2 support.


Top What is a mount?

A mount is a file location on a server.  Refer to the following chart
to help guide you in entering settings.

	http:// www.radiotoolbox.com :80 /myfile.mp3
        ------- --------------------  -- -----------
        |     | |                  |  || |         |
        |    /  |                 /  /  \ \        |
      PROTOCAL       SERVER          PORT    MOUNT
     (not used)


Top Why does Radio ToolBox forget my username and password for a server when I restart the application?

This is for security reasons, it is best at this time to leave the 
password and username of your servers stored in memory then deleted
when the application closes.  Especially considering the fact that it
is a beta application.


Top Does my username and password for my server get transmitted?

The username and password for authorization are only transmitted when
they are needed at the stat gathering phase, they are not transmitted
to our server or to the UWS or FIS service.


Top What is UWS?

UWS stands for Universal Web-integration Service,  this is essentially
a specific job the application does to help you send information
about your station to a web service such as a Website or Database.


Top What all is sent via UWS?

Essentially everything RTB knows about your servers, as well as
the default server's current song and a total of your server's
listener count and max listener count, and the touch interval for
the application.


Top How can I integrate this into my website?

You can use the pre-made scripts packaged with the installer.

Currently they are:
   - PHP scripts

Read the read me with the corosponding scripts for information on how
to install and use the scripts.


Top What scripting language does UWS support?

As far as I know it supports all of them.


Top I am a developer who writes in X scripting language, can I write a catcher for RTB's UWS in my own language?

Sure you can, and if you do we sure would like to have a copy for
distribution to other users.


Top How is the information sent to the script?

The information is sent as in the form of a FORM.  It uses the POST
Method as it's transfer mechnism.  We used POST because of it's
ability to scale better then GET.

The following form names are passed

This is a multidimensional array, n stands for the server number
server[n][0] = SERVER's IP AND PORT
server[n][1] = SERVER's TYPE (i.e. SHOUTcast, Steamcast, Icecast2 etc)
server[n][2] = SERVER's LISTENER COUNT
server[n][3] = SERVER's MAX LISTENER COUNT
server[n][4] = SERVER's BITRATE
server[n][5] = SERVER's STATUS (Online, Offline (No Source!) etc)
server[n][6] = SERVER's TITLE
server[n][7] = SERVER's CURRENT SONG

user = RTB Username
pass = RTB Password
cmd  = <Not Implemented>
tit  = Current Song
l    = Total Listener Count
ml   = Total Max Listener Count
ti   = Touch Interval
hr   = Hour Post was sent
mt   = Minute Post was sent
sd   = Second Post was sent
mh   = Month Post was sent
dy   = Day Post was sent
yr   = Year Post was sent

What your script does with the information from that point is up to
you.


Top What is FIS?

FIS stands for FTP Interface Service.  This service simply
opens a template file created by you, inserts relevent data in the
place of TAGs and sends the file to a remote server via FTP


Top What does the different options in the FTP setup mean?

FTP Username   = Username for FTP server (leave blank for anonymouse)
FTP Password   = Password for FTP server (if anonymous use email)
FTP Server     = The Domain or IP of the FTP Server
Upload Folder  = This is the folder to store the completed file on the
                 FTP server reletive to the Root Directory or entry
                 directory when logging in.
Uplaod File    = This is the name to use for the completed file
Template File  = Location of the template file


Top What should be in the Template file?

This can be whatever you'd like, the provides greater customizability
of the information sent via FTP.  View Template.txt for an example
of how to use the templating system.

The Tags replaced are:
   <!--RTB CURRENT SONG-->	This shows the default server's
				current song

   <!--RTB LISTENERS-->		This shows overall listener
				count

   <!--RTB MAX LISTENERS-->	This shows overall max listener
				count

   <!--RTB STATUS-->		This shows the default server's
				availability

   <!--RTB DESCRIPTION-->	This shows the default server's
				name

   <!--RTB CURRENT ARTIST-->	This shows the default server's
				currently playing artist
				(anything before ' - ' in the 
				Winamp Playlist)

   <!--RTB CURRENT TITLE-->	This shows the default server's
				currently playing title (anything
				after ' - ' in the Winamp Playlist)


   ---The following tags are still underconstruction, but do work---

   <!--RTB HIST COUNT-->	This shows the amount of songs in
				the RTB History Buffer (Output is
				0 - 20)

   <!--RTB # SONG-->		Display #th song in the history
				list (i.e <!--RTB 1 SONG--> will
				show the last song played)


Top Does FIS Support Multiple file uploading?

Not at this time, the reason is it drastically affects the speed and
performance of the application to add more FTP sessions as FTP is
much slower then HTTP.  It is our hope that most who need multiple
file support will use the UWS system rather then FIS.


Top Where are FTP errors displayed?

FTP errors are displayed in the Current Status Window which is
available by navigating the tools menu of RTB or by pression Alt+C,
The application's status window will display a notice if an FTP
error has occured.


Top Who all is on the Devlopment team for Radio ToolBox?

Me, Jay Krivanek, that's it


Top Do you have much of a life?

Rarely, I spend most of my time chained to a desk or a computer. :9