Getting Started

• Overview
• Methods of Locker Loading

Scenarios

• Locker Load of a single file
• Locker Load using a zip file
• Locker Load using password
  protected zip file
• Locker Load using m3u playlist
  • Minimum playlist
  • Advanced playlist features

Implementation Details

• Obtain Partner Token
• Locker load using HTML/JavaScript
  • Include the JavaScript in your page.
  • Add the locker load links.
• Locker load using MP3tunes API
  • Obtain a session ID
  • lockerLoad API call Parameters
  • lockerLoad sample request
  • lockerLoad sample response

ADVANCED PLAYLIST FEATURES

MP3tunes recognizes some custom extended m3u playlist entries that can be used to enhance the user experience. For more information on the extended m3u file format in general, please refer to the Wikipedia page on the subject, or the original description in the Winamp forums.

#EXTTITLE

Specified anywhere in the playlist, a line beginning with #EXTTITLE will be recognized as a playlist title for the tracks included in the playlist. When creating a playlist in a user’s locker of the tracks loaded, this value will be used as the playlist title. See example below.

#EXTALBUMARTURL

A line beginning with #EXTALBUMARTURL can be used to specify the URL that can be used to fetch an album art image for the tracks. An album art URL can be specified either as a single URL for every track (assuming the tracks are all from the same album), or as a separate URL for each track in the list (assuming the tracks are from multiple albums).

Album art URL values are assumed to be listed in an order that corresponds to the tracks in the list. It is necessary that there either be a single URL specified, or one URL for each track in the list. If there are multiple tracks from the same album in the list, but tracks for more than one album in the list, it is necessary to specify album art URLs for each track.

Examples

Tracks from a single album:

#EXTTITLE:Devo - Best of Devo Vol. 1
#EXTALBUMARTURL:https://store.example.com/download/A32X5yz.jpg
https://store.example.com/download/A32X5yz-1.mp3
https://store.example.com/download/A32X5yz-2.mp3
https://store.example.com/download/A32X5yz-3.mp3
https://store.example.com/download/A32X5yz-4.mp3
https://store.example.com/download/A32X5yz-5.mp3
...

Tracks from multiple albums:

#EXTM3U
#EXTTITLE:Devo - Best of Devo Vol. 1
https://store.example.com/download/A32X5yz-1.mp3
#EXTALBUMARTURL:https://store.example.com/download/A32X5yz-1.jpg
https://store.example.com/download/A32X5yz-2.mp3
#EXTALBUMARTURL:https://store.example.com/download/A32X5yz-2.jpg
https://store.example.com/download/A32X5yz-3.mp3
#EXTALBUMARTURL:https://store.example.com/download/A32X5yz-3.jpg
https://store.example.com/download/A32X5yz-4.mp3
#EXTALBUMARTURL:https://store.example.com/download/A32X5yz-4.jpg
https://store.example.com/download/A32X5yz-5.mp3
#EXTALBUMARTURL:https://store.example.com/download/A32X5yz-5.jpg
...

Note that it does not matter if the album art URL values are interspersed within the track URLs, only that they are in the same order. The list could also look like:

#EXTM3U
#EXTTITLE:Devo - Best of Devo Vol. 1
https://store.example.com/download/A32X5yz-1.mp3
https://store.example.com/download/A32X5yz-2.mp3
https://store.example.com/download/A32X5yz-3.mp3
https://store.example.com/download/A32X5yz-4.mp3
https://store.example.com/download/A32X5yz-5.mp3
#EXTALBUMARTURL:https://store.example.com/download/A32X5yz-1.jpg
#EXTALBUMARTURL:https://store.example.com/download/A32X5yz-2.jpg
#EXTALBUMARTURL:https://store.example.com/download/A32X5yz-3.jpg
#EXTALBUMARTURL:https://store.example.com/download/A32X5yz-4.jpg
#EXTALBUMARTURL:https://store.example.com/download/A32X5yz-5.jpg
...

Note that the standard #EXTM3U line at the top of the list is not strictly required, but is shown for convention. The standard #EXTINF line is also optional, and is ignored if present.

Developer Forums

Have questions or ideas about development? Join the developer forums.