CDMagic User Manual

Notice:
The current version of CDMagic is in the beta-state. Any error reports from you are welcome, so are your comments and suggestions. Please mail to the
CDMagic Development Team.

Welcome to CDMagic for OS/2!

It's the complete solution for MP3 music on PC, and for managing your audio compact discs.

CDMagic provides following functions under one easy-to-understand graphical user interface:

  • CD-player and MP3-player
  • CDDB-access for track data etc. (internet connection required)
  • MP3-conversion (encoding)
  • integrated database for MP3-files, with SQL-like command syntax (optional)
Most parts of the user interface are self-explanatory. Just play around and see what happens. If you are looking for a command that's not plain on the window surface: just try the context menu, especially over the Track-Title listbox and the Report listbox (remember: invoking the context menu means: clicking your right mouse button).

Contents:

  1. Installation and Setup
  2. A Quick WalkThrough
  3. Basic Concepts
  4. Reference
  5. Appendix-1: About CDDB
  6. Appendix-2: Troubleshooting

Installation and Setup

To install CDMagic, you just unzip the distribution- (download-) file into a directory of your choice, let it be
c:\>cdmagic

(If you read this manual, then it seems you already have successfully done that). After unzipping you should generate some objects on your desktop. To do this you open a OS/2 command line session and from your cdmagic-directory run the INSTALL.CMD. This will generate a folder, which you can open and in it you find a program icon, which you can double click on to start CDMagic.
Note:
Please make sure that in that program object the field 'Startup directory' is set to your CDMagic-directory.
Update your CONFIG.SYS:
  1. include the CDMagic-directory in the PATH-statement
  2. include a '.;' (period semicolon) in your LIBPATH-statement (which means that DLLs are found always in the home-directory of the main program)
Setup:
At the first start of CDMagic you are presented the 'Settings'-window. Here you must enter some important information, esp. on the paths to your audio files (MP3 and WAV).
Considerations on harddisk space:
Please keep in mind that your audio files will occupy large amounts of harddisk space. For each hour of MP3-music you need approximately 50 MB disk storage. That means, if you have 100 CDs of 1 hour each and want them played from your harddisk you should not have less than 20 GB free space at your MP3-path.
In addition, you need temporary disk space for the WAV files, which are generated by ripping the tracks from CD. To process one CD of 1 hour of music you must provide temporary free disk space of about half a GB. After converting them to MP3 you can delete the WAV files. Important note:
If you don't have as much free space now, you can start building your music database either. Go on until your space is exhausted, then you can add a new harddisk drive into your system, and just tell CDMagic that you have a new MP3-path. You don't need to migrate your old music files, you just leave them on their old drive. CDMagic will still find the files through means of the database.

[ Back to top | Quick Walk Through | Basic Concepts | Reference ]


A Quick WalkThrough

Using CDMagic
Assume you have a CD with 12 tracks on it, 9 of which you want to have converted to MP3 and loaded into your database. Follow these steps:
  • Have your PC connected to the internet.
  • Insert the CD into the CDROM drive.
  • Click the 'Refresh CD'-pushbutton.
  • Click the 'CDDB'-pushbutton.
  • Wait until the 'Track-Title'-listbox changes to the actual title names and the CD name and artist is displayed in the entryfields on top.
  • Select the tracks that you want to process (s.note-1).
  • Invoke the context menu (s.note-2).
  • Choose your desired action from the context menu (s.note-3).
Notes:
  1. Selecting tracks:
    left click on the first track; for all additional tracks to select hold down the ctrl-key and left click on that track
  2. Invoke the context menu:
    move the cursor over the Track-Title listbox and click the right mouse button. A popup menu appears.
  3. Choose your desired action:
    If you want to load the tracks as MP3 sound file then you click on the 'rip and mark for convert'-choice.
    (If you would want only the track data loaded into the database without producing a sound file, you would choose 'insert empty titles'.)
Wait now until the ripping of the tracks is finished (that may take a few minutes, depending on the speed of your CDROM-drive). You can observe the ripping process by looking at the Log window at the bottom of the Main Window.

After your are done:

When all the tracks have been ripped you can have a look at the database and see where the tracks are. Click on the Query-pushbutton. You now enter the Report window. Usage of the Report window is mostly self-explanatory. For further information you can press the F1 key for online help.

[ Back to top | Quick Walk Through | Basic Concepts | Reference ]


Basic Concepts

Conceptually the program is based on the idea that large hard disks are inexpensive and easily available. So if you have free hard disk space of about 10 to 20 GB you are ready to go into the future of convenient music listening and - what's more - music administration. With CDMagic in addition this future is here right now.
So the dominant function of CDMagic is not the player, but the database, accompanied by the internet-
CDDB-function. That's the Magic in CDMagic: while building and maintaining a database is usually cumbersome and requires a lot of manual data entry, this is not so with CDMagic: the integrated CDDB-access supplies almost all the data your database needs.

The Database

The database concept in CDMagic aims at completeness of title-related data as well as easy retrieval of all information, to suit the need of the user, i.e. to answer every possible question about your music data you can imagine. To make you not dependent on the CDMagic program to utilize your database we have chosen to build the database in dBaseIV-format. So even if you at any time in the future will cease to use CDMagic, you still have your precious CD data, which you can import or directly use in any other application, that supports the DBF format (e.g. StarOffice, Lotus Approach).

What's in the database

Primarily, each track of a CD goes into the database (of course, only those tracks that you select, if you don't want them all). So, each database entry represents one track on a CD, regardless if
  1. the track is converted to MP3 (which is presumed to be the 'normal' case)
  2. or
  3. is still in the WAV-format
  4. or
  5. has no corresponding music file at all (we call those database entries 'empty' titles).

WAV- or MP3-format?

Just to remember: WAV is the format of the sound file after it has been ripped from the CD. MP3 is the format after the WAV file has been converted ('encoded') by a special MP3 encoder program. WAV is about 12 times larger than MP3, while sound quality of MP3 is slightly inferior.
While in CDMagic it is assumed that you intend to have your music files in the MP3 format you are not enforded to do that. You are free to decide on each track to have it converted to MP3 or leave it as WAV file. How is this decision made?
In CDMagic converting to MP3 is done in two steps:
  1. ripping from CD and store as WAV file
  2. deliberatly convert (all or some) WAV file(s) to MP3
So, in order to leave a music file in WAV format you just don't convert it. The CDMagic database will know that this file is WAV and - if you want to play it - start the appropriate WAV-player for it. The only thing you have to keep in mind is the much greater disk space the WAV-files need.

Database administration

At first start you don't have to bother about the database: it is built automatically by the program. Database backup:
You should keep in mind that the term 'database' in CDMagic stands only for the track data and other CD related information, not the music files themselves. The latter occupy most of the disk space by far, but the former may be regarded as more important, because it is harder to recover. So the best you can do is backup both parts of your data.
To backup the database alone: from an OS/2 command line session, in the CDMagic-directory, you enter:
copy *.dbf  a:
in order to backup the database files to disk drive a: (of course you can choose any other drive or backup media).
To restore the database you must COPY the files back into the CDMagic-directory, and then re-build the indexes: in CDMagic you click on the Main Menu 'database - rebuild indexes'.
To backup the sound files: This is more difficult, because you need a large backup medium (target drive). The best solution is to use a backup device, such as a tape drive or a CD writer. Database rebuild:
From a technical viewpoint you will not have the neccessity to rebuild the database in the whole life. But in practice this will happen, especially in the first time. Because most probably (and strongly recommended) you will first build a database for exercising, and after you have captured what it's all about then you can drop your 'scratch'-database and start over again. Note: For security reasons there is no integrated function to drop the database. To start with a new (empty) database you have to open an OS/2 command line and enter the following:

	del *.dbf
	del *.ndx
	del *.adx
	del *.mdx
In case you already have WAV- or MP3-files:

	cd x:\wav_temp-directory  < -- where the WAV files reside
	del *.wav
...deleting the MP3-files:

	cd x:\mp3-directory  < -- where the MP3 files reside
	del *.MP3
Then you start CDMagic again. You receive the message (in the Log window) that there is no database. So you must create it: click on the main menu item 'database - create'.

[ Back to top | Quick Walk Through | Basic Concepts | Reference ]


Reference:

 How to play music from the database

Window Elements and Menu Items:
  The Main-Window
 The Report-Window ('Query')
 The Aggregate-View-Window
 The Settings-Window

[ Back to top | Quick Walk Through | Basic Concepts | Reference ]


Playing Music from the Database

Now that you have ripped (and encoded) your tracks you want to hear them playing.

Common rules:

There are several ways in CDMagic to play a title, depending partly on your settings and partly on the actual situation resp. environment.
Before going into the details, here are some rules that always apply:
  • Whenever you see a title displayed in any of the CDMagic-windows there's a way to play it
  • Playing a single title is done by doubleclicking on it.


  • Here's where the common rules end.
  • To stop a title playing (depending on your Settings):
    > if you chose WarpAmp or PM123 you press the 'Stop'-button on these programs.
    > if you chose chosen tWaveP or tWaveMD you doubleclick once again on the title (this is because tWaveP and tWaveMD don't show up on the WPS, i.e. you don't see them playing and they don't have a 'Stop'-button)
  • To stop a title playing (depending on actual situation):

Using the Playlist:

From within the Report-Window you can put selected titles in a playlist. Just select the titles, invoke the context menue and choose 'Add to Playlist'.
In the Playlist-window you cannot play a single title but only the complete list. Press the 'Play List'-button.
You can rearrange the order before starting to play: click with your right mouse boutton on the title you want to place at another position, hold the mouse button down and drag onto the required position; release the button.

Playing tracks directly from the CD:

Usually in CDMagic you play titles from the CDMagic database. But CDMagic also lets you play directly from the CD.
If you have a CD in your CDROM drive and from the CDDB you have retrieved the title and artist names then you might want to here selected titles, before deciding to rip and convert them.
  • To start playing: doubleclick on that track in the Title List box.
  • To stop playing: doubleclick on that track again.
  • To start another track playing: doubleclick on another track in the Title List box
Instead of retrieving the title and artist names from the internet (CDDB) you can have CDMagic look into its database and see if the CD is already present there (i.e. you have ripped and encoded this CD some time before).
To do this you set the checkbox 'Look in DB' to ON and press the 'Refresh-CD'-button.

[ Back to top | Quick Walk Through | Basic Concepts | Reference ]


Appendix-1: About CDDB

CDDB stands for Compact Disc Database. It is a large database which contains information about nearly every CD ever released in the world. Among these informations are: disc title, artist name and track titles and some more. The database is originally located at
www.cddb.com and there are several mirror sites around.
Identifcation of a specific CD occurs by a specially calculated disc-ID, which is unique for every CD and acts as the primary key in the database.
Access to the CDDB is handled by a special protocol (over TCP/IP), which is incorporated in CDMagic, so you don't have to bother about it.
More details in english language coming real soon now ... (please watch out for latest news on our web site at http://www.cdmagic.de.
Thank you for using CDMagic.

[ Back to top | Quick Walk Through | Basic Concepts | Reference ]


Appendix-2: Trouble-Shooting

First, check the installation prerequisites:
  1. Did you execute the INSTALL.CMD to create WPS-objects for CDMagic?
  2. Do you have emx installed (at least vers. 0.9c is required)
    To get and install emx refer to
    www.cdmagic.de.
  3. Is your CD drive letter correctly specified in the Settings window?
  4. Is your CDMagic directory included in the PATH? (ref. to your CONFIG.SYS)
  5. Do you have an open connection to your internet-provider when executing the CDDB-function?
To learn more about the nature of your error, you can inspect the Log window at the bottom of the Main Window. Doubleclick on the message that indicates an error. On the upcoming dialog prompt you can click the HELP-button, where you get some of the most often occurring return codes explained.

If nothing helps: write an error report by ordinary email to the CDMagic Webmaster, or fill in the Error Form in the CDMagic website.


[ Back to top | Quick Walk Through | Basic Concepts | Reference ]