SkyMinds.Net

Song Displayer is a WordPress plugin that displays what is playing in Winamp or SAM Broadcaster on your blog.

How it works

The plugin consists of 4 files :

• mp3-in.php is a template for Winamp, used to generate the playlist.
• mp3-in-sam.php is a template for SAM Broadcaster, used to generate the playlist.
• mp3-out.php is the generated playlist with ID3-tags. This file will be uploaded on your server every time a song plays.
• song_displayer.php is the WordPress plugin to be placed into your /wp-contents/plugins/ directory.

The plugin reads the generated playlist and extracts the information to display the data contained in the ID3v1 tags. If the tags are incomplete or missing, the plugin displays the name of the files. By default, the artist name and song title is displayed, along with the album title if available. If the playlist hasn’t been regenerated in the laps of time you define, the plugin assumes your webradio is off and displays a ‘Radio is off’ message. Otherwise, it displays the song info on your blog and you can link it to your Shoutcast or Icecast stream.

Download

http://www.skyminds.net/?download=song_displayer

Install guide for Winamp

First, you need the DoSomething plugin for Winamp.
Once installed, go to Winamp > Préférences > Plugins > General Purpose > DoSomething and select Configure. Activate the plugin by unticking the Disable Plugin box.

Playlist creation

In the drop-down menu, select Generate HTML Playlist. In Template In, enter the path of MP3-in.php that resides on your hard-drive. Do the same for Template Out with MP3-out.php. Click Update to save the changes.

Upload the playlist on your server via FTP

Once the playlist generated, you nedd to upload it on your server. Select the FTP service in the drop-down menu and fill in the fields with your FTP account info :

That’s it. Now on to the plugin configuration.

Install guide for SAM Broadcaster

Setting up the playlist generation in SAM is pretty straight-forward :

• place mp3-in-sam.php and mp3-out.php in your /Program Files/SpacialAudio/SAMBC/samHTMweb/ directory.
• go to File > Config > HTML Output and add a new rule for playlist generation, using mp3-in-sam.php as input file and mp3-out.php as output file.
• tick Auto-upload generated file via FTP and configure your FTP access.
• done !

Here is a screenshot of the configuration on SAM :

Plugin configuration

Upload the plugin

You now need to upload song_displayer.php in your /wp-contents/plugins/ directory. Chmod it 666 with your FTP client (right-click on the file > Chmod/permissions > 666) to be able to edit it via WordPress plugin editor.

The plugin has got 3 options : the URL of the playlist (mp3-out.php) from the index page of your blog, the delay in seconds before assuming Winamp is turned off (7 minutes by default, edit this value according to the average length of your songs) and the URL of your webradio stream if you have one.

Data integration on your blog

This is the last step : add the following code to your sidebar.php template where you want the information to appear :

<?php if(function_exists('show_playlist')) { show_playlist(1, " - ", ""); } ?>

Function parameters

1. First parameter : number of lines to display. Default is 1 : current song.
2. Second parameter : separator between artist and song names.
3. Third parameter : separator used for multiple lines. Default is blank, otherwise put a linebreak.

That’s it ! You should now be set and have what’s playing in Winamp or SAM Broadcaster displayed on your blog.