From kJams Wiki
Jump to: navigation, search

CAVS is a manufacturer of standalone karaoke disc players, jukeboxes, and streaming audio servers. Their hardware line includes the widely-used DVD-203G series which can play traditional CD+G discs, Video CDs, SuperCDG discs (which are actually DVD-ROMs), and external storage devices connected to its USB port, such as a hard drive or USB "key" drive.

Songs on external devices are stored in a series of folders, one for every disc 'ripped' into the system:

 SC08\         <- Folder with "Disc/Album" Name
   00001.MCG   <- graphics file for song #1
   00001.MP3   <-    audio file for song #1
   00002.MCG   <- graphics file for song #2
   00002.MP3   <-    audio file for song #2
   ENGLISH.INX <- encoded text for on-screen navigation menus, includes meta data
   list.txt    <- Text file containing song and artist info (meta data) for each track
   songlist.txt<- Another type of text file containing meta data.
   JUKE.TXT    <- Yet another.

The "[song]list.txt" or "juke.txt" file provides Artist and Title meta data for all songs in the folder where it resides. It is formatted like so:

 Song#|Song Title|Artist Name
 00001|My Best Friend's Girl|Cars, The
 00002|These Boots Are Made For Walking|Nancy Sinatra
 00003|She's A Lady|Tom Jones

Or like this

#start : 0000           (start song number) number = start + code
#path  : backup           (work directory)
#work  : MP3,CDG,TXT
0001 I WILL ALWAYS LOVE YOU                 WHITNEY HOUSTON     	; cb9e64, cbcfa9 [2214,182]
0002 SIMPLE LIFE                            ELTON JOHN          	; cbd206,1d5f280 [2740,259]
0003 I'LL BE THERE                          MARIAH CAREY & TREY 	; cbfd5d, cc2ce2 [219a,299]
0004 REACH OUT I'LL BE THERE                MICHAEL BOLTON      	; cc2fe7,1d5f4d9 [1f82,2a3]
0005 JUST FOR TONIGHT                       VANESSA WILLIAMS    	; cc615b,1d5f77c [21bf,255]

Or like this:

000002|SIMPLE LIFE                         |ELTON JOHN
000003|I'LL BE THERE                       |MARIAH CAREY & TREY
000005|JUST FOR TONIGHT                    |VANESSA WILLIAMS

or in a couple other, similar formats. There is also a binary type called "english.inx".

You MUST have one of these four files in the same folder as your numbered music files in order to get the meta data.

Importing into kJams

  1. Launch kJams and choose "Add To Library..."
  2. Choose a CAVS disc folder containing MCG and MP3 files.
  3. There's no step 3! kJams automagically detects the CAVS list.txt file inside the folder and uses its contents to tag all songs with appropriate artist and title names. It even adds genre information like "Musical" or "Duets" whenever possible!

Note 1: if you get asked whether to use "File Names" or "Tags", pick "File Names" but only because it is slightly faster, it doesn't really matter if you pick "Tags" or if you have it set to automatically always pick "Tags".

Note 2: If your discs were originally ripped using improper meta data or poor CAVS software settings, the resulting list.txt files can look pretty crummy; missing punctuation, truncated names, and ALL CAPS are common problems. kJams corrects as much as it can by filling in common punctuation and setting words in Capital Case. If you want better results, edit the list.txt file(s) before importing, or edit the resulting name fields within kJams after importing.

Note 3: Unless you "push meta data" or edit the meta data for every song in the import, then it's recommended that you also keep the list.txt file for future re-importing, in case you ever need to rebuild your kJams library from scratch. If you have edited or pushed all the meta data, then you can throw this file out.

IMPORTANT NOTE FOR CONTINUING CAVS USERS: If you plan to continue using your MCGs and MP3s with CAVS, it is strongly recommended that you create a backup copy in another location before using them with kJams. This is because kJams renames the files for any song whose info you modify within its list view.

For example, if you entered "Cars - Gary Numan" into the title and artist fields for unnamed song "00004", the 00004.MCG and 00004.MP3 files would become 'Cars - Gary Numan.MCG' and 'Cars - Gary Numan.MP3'. The new names of the files make them unusable with CAVS.