Jukebox

Jukebox Controls
>| or >>     Skip Track
Stop Key    Stop Jukebox
 
Random Play
This option plays mp3 files in the MP3 directory and its subdirectories at random.
The random play has a 10 track playlist history buffer to prevent the same song being played twice. 
 
Random Play Track Selection Logic
Track are selected by going to the MP3 directory and counting the number of folders and files in the directory.
 
1. The program then generates a random number and goes to the file or folder indicated by the random number. If a folder is found the file program repeats step 1. If a file is found the program proceeds to step 2.
 
2. The file found is checked against the playlist history buffer. If the file is not in the history buffer or we have being looking for more than 2 seconds it is played otherwise then program moves back to the MP3 directory and goes to step 1.
 
If you have less than 10 tracks in your MP3 directory the Jukebox will take longer to change track as it will time out looking for unplayed tracks.
 
PlayList Sequential
Press OK on the Playlist Sequential menu and the tap will display a menu of playlist files found in the directory /PlayLists. Select the list you want to play and press OK to start playing the mp3's in the order they are listed in the playlist.
 
PlayList Random
Press OK on the Playlist Random menu and the tap will display a menu of playlist files found in the directory /PlayLists. Select the list you want to play and press OK. The program will ask if you want to reset the play list history. Select Yes to clear the history or no to keep. The program will then start playing the mp3's in the playlist in random order.
 
Playlist Random mode has a playlist history buffer that records the last 50 tracks played. If you have 100 tracks in your playlist once the 100th track is played the play history buffer is cleared completely.
 
PlayList Directory
Playlists are stored in the directory PlayLists which you need to create using Altair. It appears that this is case sensitive so you must name the directory as specified. The PlayLists directory also stores playlist history files which have the extension .hst.
 
   
 
PlayList Specifications
Maximum number of tracks is 2000.
Maximum playlist size is 204800 characters.
Maximum File name length is 100 ( Set by Topfield API )
Maximum Folder name length is 100 ( Set by Topfield API )
Maximum Folder path length is 512 ( i.e. MP3\Artist\Album\ )
 
PlayList Creation
I have my mp3 database on both my PC and on the Topfield.
On the Topfield the mp3's are stored in the directory /MP3.
On the PC the mp3's are stored in the directory C:\Music 
 
The Playlist is a text file listing the full path and filename of the mp3 to play. (See sample Playlist01.m3u)
 
The extension on the playlist must be .m3u
 
On the PC I use MusicMatch to manage the mp3 database and create playlists. I then use Altair to transfer the playlist to the PlayLists folder on the Topfield. I have set Mp3Prefix=c:\music\ in the ProgressBarKeys.ini file so the program knows to change the playlist paths from c:\music\ to MP3.
 
PlayList History
The Jukebox keeps track of each track played in a Playlist history file for each playlist in the PlayLists directory and Random.hst for the random mode playlist history. The playlist history records only the track name not the path to the track. The playlist history will store up to 50 tracks for playlist random mode and 10 tracks for random mode.
 
Suggested MP3 folder Structure
MP3\ARTIST\ALBUM\TRACK
 
 
           
 
MP3 Slideshow or Album Art
 
Damian has written an Slideshow TAP the will display slideshows during MP3 playback and/or album art during PBK jukebox playback.
MP3Show TAP

Jukebox Trouble Shooting

1. The Topfield and PBK will only play files with the extension .mp3
2. The PlayLists directory/folder name is case sensitive. If you created the directory/folder as playlists it will not work.
3. Playlists must have the extension .m3u
 

ProgressBarKeys