HOW TO add Radio Monitor custom button in MusicMaster

Custom Button Radio Monitor - Setup

 The purpose of this document is to describe how to setup a working custom button pointing to the Radio Monitor website.

1. Preparation of the environment

A/ Open your MusicMaster database and note down the field number values of the following three fields:

• XXX: field containing the Song ID of the automation system (you may also choose the actual Song Id, if you prefer)
• YYY: field containing the Artist
• ZZZ: field containing the Title​

Below please find a series of screenshots that will help you in the process. 

Note: the field names and numbers may vary depending on the database used. Here they are called respectively: 

1. ID (field number: 101) 
2. Artist (field number: 102) 
3. Title (field number: 103)

 

B/ Do you have the Radio Monitor logo? 

If not, you can find it below AND as an attachment to this document.

Once you have saved the above image as a .gif file on your computer (or after downloading the attachment), you have to cut or copy it into your MusicMaster installation folder (the same which contains the file MusicMaster.exe).

C/ Do you have a valid Radio Monitor account? If so, connect to Radio Monitor and login with your credentials. It is suggested (but not mandatory) to save your credentials at this point, in order not to have to insert them again at every connection.

D/ Don't you use Internet Explorer as default browser? If so, we suggest to start doing it. MusicMaster is developed, tested and supported within an IE environment, even if most of its functionalities work also with other browsers.

Done? Let's move on to the next step then.

 

2. MusicMaster.ini file

This file is usually located in the MusicMaster installation directory.

Two possible cases here:

A/ MusicMaster.ini not present. In this case a new empty .ini file has to be created inside MusicMaster installation folder (remember? You already saved your Radio Monitor logo in that folder!). Then you have to rename the file as "MusicMaster.ini".
Alternatively, you can download the .ini file attached to this document and modify it.

You have now to open it with a text editor and to copy-paste the following text into it:

;;;;;START_FILE;;;;;;

[UserButton1]

;RadioMonitor

Image=RadioMonitor.gif

ToolTip=Radiomonitor

Internal=1

URL=http://www.radiomonitor.com/mm/musicmaster_manager.php?UniqueID=%FLD:101%&artist=%FLD:102%&title=%FLD:103%​

;;;;;END_FILE;;;;;;

Some explanation for the fields marked in red.

• "Internal=1" means that you want to launch Radio Monitor within MusicMaster Web Browser Page. If you prefer to navigate via a full browser window (Internet Explorer), we suggest you to set this value to "0" or to remove this line from the above example.
• "%FLD:101%" Do you remember the screenshot which shows the ID, artist and title field number in MusicMaster? If so, you may remember that 101, 102 and 103 where the resulting values in our sample database. Of course, things can be different in your database. In this case you will have to replace the numbers in red with the ones noted down from your database..

B/ MusicMaster.ini already present. In this case you should open it with any text editor and add the following section:

;;;;;START_FILE;;;;;;

[UserButtonX]

;RadioMonitor

Image=RadioMonitor.gif

ToolTip=Radiomonitor

Internal=1

URL=http://www.radiomonitor.com/mm/musicmaster_manager.php?UniqueID=%FLD:101%&artist=%FLD:102%&title=%FLD:103%​

;;;;;END_FILE;;;;;;​

Some explanation for the fields marked in red.

• The "X" in the [UserButton] element definiton line has to replaced with an integer number. If you didn't have any UserButton in your .ini file, this number has to be 1; if you add already set up other customized buttons in your .ini file, you should insert a value equal to the highest one present in the .ini file + 1. Example: you already had two user buttons? X in this case should be equal to 3. Note: With MusicMaster 5.0 SR 15 you can add up to 5 User Buttons, so 5 is the maximum amount. 
• "Internal=1" means that you want to launch Radio Monitor within MusicMaster Web Browser Page. If you prefer to navigate via a full browser window, we suggest you to set this value to "0" or to remove this line from the above example.
• "%FLD:101%" Do you remember the screenshot which shows the ID, artist and title field number in MusicMaster? If so, you may remember that 101, 102 and 103 where the resulting values in our sample database. Of course, things can be different in your database. In this case you will have to replace the numbers in red with your own ones.

 

3. Let's give it a try!

Please close all the instances of MusicMaster and restart it. Open your database and you should now have a button identical to the one below:

If so, the only thing left, is to try it out. First, if you inserted "Internal=1" in the .ini file, you should make sure that the web browser view is ticked as showed below:

Now, just selecting a song from your library and clicking on the newly created "Radio Monitor" button, you will have something like the picture below in the web browser window.
Note: if you selected "Internal=0" or you removed that line from MusicMaster.ini file (see step 2 of this tutorial), a new window will automatically open in your browser each time you click on your Radio Monitor button within MusicMaster.

4. Done?

​If you got something like the above picture, everything worked fine and you can play with Radio Monitor as you like. We assume you are already familiar with the tool, and explaining how it works is outside of the scope of this tutorial. However, you can find more information about this product on the website www.RadioMonitor.com.

If you didn't get the expected result, do not hesitate to contact us at the following e-mail address: support@onair.de. We will be happy to help you setting up your environment!