DOWNLOADS EXAMPLES SKINS DOCS SUPPORT
 
 

The Wimpy XML Playlist Format

An XML playlist is a text-based XML file that contains information about each file you would like to present in the player. The WImpy XML playlist format uses a simple and flexible <item> structure. If you're not familiar with XML, click here for a brief introduction to XML.

Example:

<playlist>
   <item>
     <filename>example_A.mp3</filename>
     <title>Song A</title>
   </item>
   <item>
     <filename>example_B.mp3</filename>
     <title>Song B</title>
   </item>
</playlist>

In the example above, we are showing the "minimum" amount of data that an XML playlist can contain. You are free to include additional <tags> within each <item> as needed.

Special Tags

The following special tags are used and / or displayed within Rave (if present):

NOTE: Only the <filename> tag is required, all other tags are optional.

<filename>

Fully qualified URL to the media file. Relative paths may be used, but we highly recommend full URLs. Example:
<filename>http:://www.yoursite.com/path/to/file.mp3</filename>

<artist>

Composer's name.

<title>

Track title.

<seconds>

Total playtime in seconds. You may use a "float" number such as 124.4364.

Do not use "min : sec" format (e.g. 3:16)

This tag can be used to limit the play time of each track. Whatever number of seconds is established within this tag is the total number of seconds that the track will play for. For example, if you set this tag to <seconds>15</seconds> then only the first 15 seconds of the track will play.

<description>

Additional information about the track, which will appear within the "more info" dialog when the user clicks either the cover art or "more info" button in the playlist.

<image>

URL to cover art image.

<link>

URL to an external site or page. The URL within this tag is used:

As the button link on the cover art image
If the user clicks on the cover art image, a new browser window will open using the URL.

As the link for the "more info" button within a playlist item
When the user rolls over an item within the playlist, an arrow will appear within the item. If the user clicks on the arrow, a new browser window will open using the URL.

NOTE: The arrow icon can be changed to any image, such as a "BUY NOW" or shopping cart icon by using Skin Machine. See the "Ecommerce / Shopping Cart" how to guide.


<filekind>

Manually establishes the kind of file that is defined for the <filename> tag.

By default, Rave will attempt to determine the kind of file based on the extension of the file used for the <filename> tag. If the URL within the <filename> tag does not have a proper extension, use this tag to "force" a particular kind of file, so that Rave will know how to handle the audio, video or playlist file presented within the player.

<downloadable>

Determines whether or not the file is allowed to be downloaded. If set to "yes" the playlist item can be downloaded when a user clicks on the "down" arrow after rolling over a playlist item. NOTE: The download arrow icon can be changed to another image using Skin Machine.

 

Here is an example of an XML playlist that includes some special tags.

Note how the references in green are different between each <item>.

<playlist>
  <item>
    <filename>http://www.yoursite.com/path/to/example1.mp3</filename>
    <artist>Artist 1</artist>
    <title>Title 1</title>
    <link>http://www.yoursite.com/shoppingCart.php?action=add_item&id=2</link>
   
<seconds>35.84</seconds>
    <image>http://www.yoursite.com/path/to/example1.jpg</image>
    <downloadable>yes</downloadable>
  </item>
  <item>
    <filename>http://www.yoursite.com/path/to/script.php?getMedia=1234</filename>
    <filekind>flv</filekind>
    <artist>Artist 2</artist>
    <title>Title 2</title>
    <link>http://www.yoursite.com/shoppingCart.php?action=add_item&id=2</link>
    <seconds>205.84</seconds>
    <image>http://www.yoursite.com/path/to/example2.jpg</image>
    <downloadable>no</downloadable>
  </item>
</playlist>

 

 

 

 

 

 

  ©Copyright Plaino LLC. All rights reserved.