Step 1: Downloading and Installing BlogAmp.

To use BlogAmp you will need WinAmp and access to a FTP server. Download the file from the downloads page and extract it's contents to Winamp's plugins directory, wich is usually located at c:\Program Files\Winap\Plugins.

Notice: If, after you install BlogAmp, your Winamp stop working, just remove the file gen_playlist.dll from the plugins directory. The same must be done if you want to uninstall BlogAmp

Step 2: Configuring BlogAmp.

Start Winamp and type Ctrl+P to open the preferences window

In the list on the left, select Plugins ->General Purpose. In the list that will appear on the right, double click the item BlogAmp v0.23. The followin dialog box will appear.

In Server, type the address of your FTP server.

In Port, leave the default, 21, unless your FTP administrator tell you to do change it.

In Username, type you FTP server login name.

In Password, type you FTP server password.

Check the Save Password checkbox if you want to save you password between sessions. You password will be encrypted before it is saved.

Notice: In version 0.13 or earlier, the password is not encrypted! If you use one of these versions, any experienced user can access the Windows registry to get your password. So, if you use version 0.13 or earlier and you computer is shared with other people, you may want to let this option unchecked.

Leave the Use PASV Mode checked, unless you experience problems to update your list. In this case, you may try to uncheck this field.

Check the Disable Plugin field to completely disable the plugin. It can be useful if you wanna hear that new Britney Spears song and don't want to let anybody know that you actually like it! ;o)

In Number of Songs In List, type the number of songs that you want to appear in your web page. Note that the entire list is FTP'ed to the server every time you listen to a song. So, if you choose to display 1000 songs, your FTP transmission can take a long time.

In Log File, type the location of BlogAmp's log file, where the information of all musics played is stored. The default is Winamp's plugin directory.

In Remote Filename, type the name of the file that will be stored in the server. The default is playlist.js. This file is a JavaScript source file that contains the list of the last songs played. This file is updated whenever you play a song. The name of the file may contain a path, like in blogamp/playlist.js. Not that, by default, this file must be in the same directory of the page that contains the list. Therefore, in your page is located in the FTP directory blogamp/mp3.html, for instance, you will have to type blogamp/playlist.js in this field.

In On exit, wait..., type the number of seconds you want Winamp to wait for the FTP connection finish when you close Winamp. You may try to decrease this value if you have problems when you close Winamp and try to open other song in sequence.

The Create debug files must be left unchecked unless you have problems with BlogAmp and I personally ask you to check it. Otherwise, leave ths field unchecked, since this option creates files that use waste your disk space.

Step 3: Changing your web page

After you configure BlogAmp, you need to change your web page to display the list. You need to copy the display_playlist.js file to your server. This file contains the JavaScript code needed to format the song list in the screen. Use you favorite FTP client to perform this task. You must put this file in the same directory where your page is located.

Next, open you page in a text editor (notepad, etc) and insert the following code between the tags <head> e </head> of your file:

<script src="playlist.js"></script>
<script src="display_playlist.js"></script>

In the section where you want the list to be inserted, paste the following command:

DisplaySongs( "color: blue; text-decoration: underline;", "" );

Save your web page in the server and it's ready!

When you open Winamp, BlogAmp will send the current song to the server. Whenever the current song changes, the list will be automatically updated.

Step 4 (optional): Customizing...

The DisplaySongs command may receive some configuration parameters.

The first parameter is the CSS style that will be applied to the song names in the list. You can put here any valid CSS character string. For example, you can use the paramter
"font-face: Arial; font-size: 10pt; color: blue; text-decoration: underline;",
to make the song names appear in Arial, with 10 points in size, blue and underlined, like this.

The second parameter works like the first, but it specifies the style to be used in the details.

The third parameter is optional and indicates wether the horizontal line between the songs must be displayed. If this parameter is 1, the line is NOT displayed, and if the parameter is 0, the line is displayed (weird, i know).

Step 5: And beyond...

This is only a basic tutorial to use BlogAmp. I encourage the advanced users to open the files playlist.js and display_playlist.js and understand how they work

If you create your own version of the display_playlist.js script, that formats the list in a different way, you can send me and I will be proud to distribute it here giving the credits.

Visit my blog at :o) (portuguese only)

My playlist: