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
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
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.
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
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
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:
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
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;
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 www.geocities.com/insanitydrops/
:o) (portuguese only)