CDimgtools is a small set of command line tools to inspect and manipulate CD (and possibly DVD) images of formats uncommon on Linux/UNIX systems.

You can print information about an image file and extract its tracks to files in raw format, so that they can be used with common Linux/UNIX tools (for playing audio, reading files, burning tracks or sessions to optical media etc.).

CDimgtools was written under a Linux OS, but should work under other UNIXES and maybe on other platforms having Perl installed (see Dependencies).

Commands in the package

raw96cdconv(1)

This command demultiplexes stream data (audio, raw data or .iso format data) and sub-channel data from a RAW+96 image file. It operates on CD images containing stream data and sub-channel data of a given sector at contiguous positions; this kind of image file may be either directly created by a ripping program like readcd(1) or cdrdao(1), or extracted from another image file by nrgtool(1).

nrgtool(1)

This command reads .nrg images (created by Nero), prints the metadata about the image, and extracts, for each track, the raw data to a separate file.

Resources

UNIX manual pages that contain usage examples are available for each command.

Known bugs and limitations are mentioned in the section about issues.

Installation instructions

Download a tarball and extract it.

The quick and simple way to install CDimgtools with documentation in your home directory ~/.local is to run:

$ make .help
$ make
$ make install install-doc

Optionally, you can use the configure script to check for some dependencies and install system-wide:

$ ./configure
$ make
$ sudo make install

To configure CDimgtools you can tell configure. For example:

$ ./configure --prefix=$HOME/.local/stow/cdimgtools

or manually modify the config.make file after a call to configure.

Distributors may use the DESTDIR Makefile variable to install the files for packaging:

$ make install DESTDIR=./packagefiles

Documentation building

To avoid the installation of the documentation tool chain, pre-compiled documentation files are available in distribution tarballs whose names end in -doc.

To force the re-building of the documentation, delete the files first:

$ make distclean doc-man doc-html

Dependencies

The following tools are required:

Tool Description

Perl

The scripts are written in perl.

The following optional tools and packages are needed for (re-)creating the configure script or for building the documentation:

Tool Description

autoconf

Contains autoreconf for generating configure from configure.ac.

asciidoc (>= 8.4)

Generates HTML and (DocBook) XML from text.

perldoc

pod2man, pod2text, pod2html are used to extract the documentation from the perl scripts.

Issues

Bugs and feature requests may be reported by mail to the maintainer. Ensure that the word “cdimgtools” is in the subject.

Known bugs and limitations:

  • The image formats handled by some tools are not open: their logic can only be guessed from sample files. Consequently there can be absolutely no guarantee that a tool can handle all files of the same formats appropriately.

  • For bugs and limitations more specific to a particular command, see its manual page.

Credits & License

CDimgtools was written by Géraud Meyer <graud@gmx.com>.

CDimgtools is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.

This package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

The full text of the license can be found in the root directory of the project sources, in the file COPYING.