next_inactive up previous
Up: Meine Homepage

CDDB2TEX1
V1.0.2

written by Mark Paede2


Contents

1 What is CDDB2TEX?

CDDB2TEX is a Win32-program (written in Delphi 3) which was written to convert CDDB-data (see www.cddb.com, stored by programs like AIC or CDmax) to LATEX-Files (for TEXing cd-cover.sty/.cls3is needed). It is not a frontend for the CDDB - it can not connect to the CDDB nor can it read the necessary CD-data by itself.

With version 0.9 CDDB2TEX is able to read (MP3)-playlist-files (M3U and PLS) written by programs like WinAmp.

A (scaled) example for the layout is given in figure 1. You can fold and cut the paper and receive an excellent CD-box-inlay.

Figure: Example for the CDDB2TEX-output
\begin{figure}
\centering {\psfig{file=tori.eps, width=8cm}}
\end{figure}

2 How do I use CDDB2TEX?

If you want to use it with the CDDB, you should get a program which can retrieve data from the CDDB (see 2.3) first. Then you should catalog all the CDs you want to print a cover for and retrieve the CDDB-data for it.

Using CDDB2TEX for playlists is quite the same. You need a program which can write playlists in M3U or PLS-format. As in this format no title for the CD is stored, CDDB2TEX relies on a file-name (for the playlist) in the format artist-CDname. Important is the '-'. For spaces within the names you can use spaces or underscores, for various artists use 'various' as artist.

Now you can start CDDB2TEX, open the required data-file (open-dialog) and double-click on any entry listed in the CD-list-window. CDDB2TEX now tries to write a LATEX-file in the same directory (by default) or in the directory selected by the "Save"-dialog (for the filename refer to 3.4) which can be TEXed using either the cd-cover style or class.

The cd-cover needs the rotating.sty and therefore the DVI-file needs to be converted to PostScript (using dvips) and printed on a PostScript-printer or using GhostScript.

2.1 Where can I get CDDB2TEX?

You can get it from my homepage zipped (including this documentation as PS):

http://www.paede.de/mark/tex/cddb2tex/cddb2tex.zip.

2.2 When will the next version come?

I don't know. But I will send you a mail if you wish. Just send a mail to cddb2tex@paede.de with the subject cddb2tex-updates.


2.3 Which data-formats are supported by CDDB2TEX?

CDDB2TEX can read the data files produced by CDmax and AIC. As CDmax uses the original CDDB-format, you should be be able to use any other CDDB-program which stores it's data in CDDB-format too.

If somebody knows any further program which can or should be able to be used with CDDB2TEX just write me a short mail. I can not promise to integrate other import-filters, but maybe...

CDDB2TEX itself is not and will not be able to communicate directly with the CDDB and so it needs some program which does this for it.

Additionally since V0.9 CDDB2TEX is able to read M3U- and PLS-playlists e.g. written by WinAmp. I don't think I have to explain what this is useful for...

3 Known Problems

The most problems will occur due to improper CDDB-entries, and I can not and want not to fix every problem caused by this. But if a problem occurs very often, I might try to integrate a work-around in CDDB2TEX - just write me a short e-mail.

3.1 Special Characters

You should check the CDDB-entries for properly used special characters (see 3.2). Sometimes the wrong character-set is used, sometimes letters like ä or ø are written ae or o.

Maybe you wish to correct not properly written CDDB-entries - see the CDDB-docu how to do this.


3.2 Character Sets

The docu for CDDB says just character set ISO-8859-1 (e.g. used by Windows or Unix) or US-ASCII should be used, but not everyone reads the docu... I put in a filtering which should change the non 7-bit-characters of the Windows (ISO-8859-1) character-set to TEX-commands. Other character-sets (like DOS, CP437) will not be exported properly or may cause (CDDB2TEX-internal) problems.

3.3 Improper used "/" in CDDB-entries

The CDDB-definition for entries is "artist / title", the "/"-character is just allowed for this purpose. CDDB2TEX relies on this definition, so entries like "artist - title", "artist - title / subtitle", "artist one / artist two - title", "artist one / artist two / title" and so on will lead to (serious) problems (like non-recognition of different artists or misplaced & in the tabular-environment).

There are three solutions for this problem:


3.4 Short Filenames

Usually CDDB2TEX uses "artist-CD title.tex" as filename for the TEX-output (non allowd charcters like "*" or ":" are replaced by "_" or "-").

CDDB2TEX uses a very simple algorithm to convert long to short filenames (it just deletes lower-case-characters and cuts the remaining string to 8 characters befor adding ".tex".) This may result in filenames like "-.tex"

3.5 -, - and --

Or -, - - and - - - : You may want to correct these in the TEX-file, as probably nobody uses them for the CDDB.

3.6 No Title for the CD

Is it a problem? I remember something, but can't reproduce it.

3.7 Double-CDs

Double-CD-Covers are not implemented (see 4), so you have to do it manual.

A second problem is the non-standarized way how to label it in the CDDB - but you will see it yourself sooner or later... Probably you will find your own way how to design the cover. Maybe you want to do something which looks similar to normal CDs:

\vspace{1ex} {\Large \bf CD No. 1}

3.8 Long titles

Sometimes (on CDs with very long titles and /or long artists names) the table becomes to wide to fit on the cover. In these cases you should add a \small or \footnotesize before the \begin{tabular}.

3.9 CD list empty

Sometimes the CD-list is empty after saving. I don't know why, but I think it's a Delphi-bug.


3.10 Too many titles

Some CDs have too man tiles to fit in the table. Of course this is not a problem of CDDB2TEX or LATEX but of the limited space on CD-covers...

I see three solutions for this:


4 Wishes/Plans

4.1 Double-CD-Layout

Until now I use a 6/8-coloumn-table for double-CDs, which I create manually from two single-CD-layouts. Therefore there is the idea of an automatism for this. But as it would be a seldom used feature and is a lot of work probably it will stay an idea...

4.2 CD-List Output

Just the names and titles of all CDs in the list as a table.

4.3 Big tables

Automatically reduce the fontsize for the table or write the titles as 'normal' text instead of a table when the table would be too big for the cover. As this problem occurs very seldom probably I won't implement it in CDDB2TEX.

At least the 'normal' text option is realized in V0.9.

5 Bugs/Bug-Reports

I try to correct bugs as soon as I know them. If you have any (reproducable) problems please write me (e-mail: cddb2tex@paede.de). Probably I will need the file and the title of the CD where the problem occurs.

6 History

Something about the version-numbers: The first number stands for main-releases (complete redesign, dramatically increased functions or something like this). V0.x means that I think the program is useful but far from being ready, V1 means that it is ready (for the moment). A change of the second number means some clear improvements were done. The last one stands for done bug-fixes or minor improvements.

Other numbering could have lead to V3.1 or even 2000 instead of 1.0...

V0.5

-
First released version

V0.8

-
Added output for cd-cover.cls
-
Improved filtering for special characters (DOS CP437, ISO-8859-1)
-
Added changeable output directory
-
Corrected an empty-line-bug with various-artists-CDs
-
Changed CD-title-size from \Large to \huge with various-artists-CDs: The size is now the same like the artist on single-artist-CDs
-
Added output for multiple CDs in one TEX-file
-
First Docu written

V0.8.1

-
Multiple CDs were always written in one file, now changeable (the filename in the save-dialog is a dummy-name, which will not be used)
-
Corrected a TeX-output-bug (& % \ in names/titles sometimes were not changed to \& \% \\)

V0.8.2

-
Plain text output added (might be useful for somebody) - still a bit buggy
-
Contrary to the CDDB-docu / instead of / was used for delimiter artist/title - corrected
-
Docu about the CDDB-format updated

V0.8.3

-
Converting characters $>$ 127 to TeX-commands produced garbage - corrected
-
CD-name and title output added on plain text output
-
'?' was used in filenames when in CD-name or title - corrected
-
Characters $>$ 127 in CD-name and title were not converted to TeX-commands - corrected
-
& % \ in CD-names/titles were not changed to \& \% \\ - corrected
-
As DOS (CP437) and ISO8859-1 character sets filtering - introduced in V0.8 - does not work together, DOS-filtering was removed

V0.8.4

-
Two bugs reading CDDB-Files fixed (An error occured during writing the contents of the CD.)

V0.9.0

-
Reading of M3U and PLS-files added.
-
List-Output (additional to table).

V0.9.1

-
Bug fixed: Files built by M3U and PLS-files missed the first entry.

V1.0.0

-
Bug fixed: M3U and PLS-files gave always interpreter-column.
-
Some minor changes (program and docu)
-
Decided it's time to release V1.0

V1.0.1

(not released)
-
Bug fixed: Lines between DTITLE and TTITLE are ignored now.
-
Bug fixed: Special characters like \AA are now ended by {}
-
Added an empty line after the closing } of each cover - now all covers should have the same position on the page

V1.0.2

-
Bug fixed (introduced in V1.0.1): Error occured (list-index out of range) processing some CDDB-files.

About this document ...

CDDB2TEX1
V1.0.2

This document was generated using the LaTeX2HTML translator Version 2K.1beta (1.50)

Copyright © 1993, 1994, 1995, 1996, Nikos Drakos, Computer Based Learning Unit, University of Leeds.
Copyright © 1997, 1998, 1999, Ross Moore, Mathematics Department, Macquarie University, Sydney.

The command line arguments were:
latex2html -init_file CDDB2TEX.INI cddb2tex.tex

The translation was initiated by Mark Paede on 2002-04-06


...CDDB2TEX1
Homepage: http://www.paede.de/mark/tex/cddb2tex
... 2
e-mail: cddb2tex@paede.de
... cd-cover.sty/.cls3
cd-cover is written by Christian Holm. You can get it from your nearest CTAN-server

next_inactive up previous
Up: Meine Homepage
Mark Paede
2002-04-06