Using M3U playlists (For users with lots of MP3 files)

If you have a large number of MP3 files uploaded to the server, you may find that creating playists using the Media Library tool will take a long time.

You can generate M3U Playlists and upload these to the server, thus saving you from having to manually add each MP3 via Media Library.

While this is a powerful feature which advanced users may find very useful, it is likely that less-experienced users may find it difficult to construct relative file paths in the manner necessary for use on a server (vs. that of their home PC).

Specifying file paths

When you build your M3U files, you will normally construct them using the paths to the MP3s on their local computer.  In order for Centova Cast to use the same M3U file, however, the MP3s must be on the server, and the paths in the M3U file must refer to the paths on the server.

For example, say the user has an MP3 on his computer named C:\MP3\Rock\rock_music.mp3, and he wishes to create an M3U playlist file containing this single MP3. 

The steps would be as follows:

- Using FTP, upload the contents of the C:\MP3 folder to the media directory on the Centova Cast server, maintaining the complete directory structure. 

- So in the user's FTP client, he should see a "Rock" directory inside his "media" directory, and the "rock_music.mp3" file should appear within the "Rock" directory, just as it would on his local computer.

- In the CentovaCast web interface, use the "Update media library" feature to import the tracks into the media library.  Tracks which are not in the media library will not be recognized by the M3U import feature, even if they exist on the server.

- Create an M3U file which uses paths relative to the C:\MP3 folder for each MP3.

- So the relative paths in the M3U file should look like "Rock\rock_music.mp3".  If the M3u file specifies absolute paths instead (such as "C:\MP3\Rock\rock_music.mp3") this will NOT work because there is no such file as C:\MP3\Rock\rock_music.mp3 on the server.
Once these conditions are met, the user can upload their M3U file.

Uploading an M3U File

Users simply need to launch the media library, select the playlist into which they would like to import the M3U file, and then click Options -> Import M3U Playlist.

Tracks will be imported in the order in which they appear in the M3U file.  Note that once the tracks are imported, they will be governed as usual by the rules of the playlist into which they were imported.

(For example, if you import the M3U into a scheduled playlist, the tracks will play at whatever time you've scheduled for the playlist.  If you've imported them into a general rotation playlist, they will play with the randomization and weighting settings you've applied to the playlist, and so-on).


Troubleshooting

I can't figure out the correct relative paths!

If you are having trouble constructing your relative paths, simply open the M3U file and look at the paths it contains.  For example, say your M3U contains:

#EXTM3U
#EXTINF:123,Rock Artist - Rock Song
Rock\rock_music.mp3

Take that first MP3 filename -- Rock/rock_music.mp3 -- and prepend the account's media directory to it. The media directory will be:
/home/centova/vhosts/USERNAME/var/spool/media/

The resulting full pathname for the MP3 file is:
/home/centova/vhosts/USERNAME/var/spool/media/Rock/rock_music.mp3

Note that you can ignore differences in slashes (i.e., / vs \) as Centova Cast will automatically convert them.

I receive the error "M3U Playlist Not Received"

This indicates that the server did not receive a file upload from the web browser.

I receive the error "x track(s) were not found or could not be imported"

This indicates that the paths specified in your M3U file did not correspond to tracks in CentovaCast's media library, or the files do not exist.

If you receive the above error, consult the section above entitled "Specifying file paths", and, if necessary, the "I can't figure out the correct relative paths" section above.

Was this answer helpful?

Add to Favourites
Print this Article

Also Read