CAVS

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, "Super-CDG" discs (actually DVD-ROMs), and external storage devices, such as a hard drive or USB "key" drive, connected to its USB port.

Songs 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
   list.txt    <- Text file containing song and artist info for each track

The "list.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

Converting

To convert your CAVS library for use with kJams, you can either

1) Use kJams to rip your original CD+G discs (but not "Super CDG" discs, which are proprietary; see note below), or

2) Convert your existing CAVS files to kJams format...which is not as hard as it might seem:

Connect your storage drive to a PC and convert the .MCG files to .CDG format using CAVS' "DecoderCD+G" utility:

File:Decodericon.gif

1. Set Mode to "To CDG -From MCG, BIN"
2. Click the "Source" button and choose one of your disc folders.
3. Click "Select All" to select all files in that folder.
4. Click the "Target" button and choose the same disc folder as in #2.
5. Click "Decode." Each song now has a CDG graphics file, ready to use with kJams!

Repeat for all disc folders on your storage device. Now, connect the storage device to your Mac; you're ready to import into kJams!

Importing into kJams

1. Launch kJams and choose "Add To Library..."
2. Choose a disc folder containing converted CDG files.
3. There's no step 3! kJams automagically detects the CAVS list.txt file inside each 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: If your discs were originally ripped with improper settings, the resulting list.txt files can look pretty crummy; missing punctuation, truncated names, and ALL CAPS are common problems. kJams attempts to correct 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.