version/0.1
[cdimgtools.git] / README
blob36d4b83ff9ed4957ee74be895313b4224d53d155
1 README for CDimgtools
2 =====================
4 CDimgtools is a small set of command line tools to inspect and manipulate CD
5 (and possibly DVD) images of formats uncommon on Linux/UNIX systems.
7 You can print information about an image file and extract its tracks to files
8 in raw format, so that they can be used with common Linux/UNIX tools (for
9 playing audio, reading files, burning tracks or sessions to optical media
10 etc.).
12 CDimgtools was written under a Linux OS, but should work under other UNIXES and
13 maybe on other platforms having Perl installed (see <<dependencies,
14 Dependencies>>).
15 // Dependencies are found in the INSTALL file
18 Commands in the package
19 -----------------------
21 linkpage:raw96cdconv[1]::
22         This command demultiplexes stream data (audio, raw data or .iso format
23         data) and sub-channel data from a RAW+96 image file.  It operates on CD
24         images containing stream data and sub-channel data of a given sector at
25         contiguous positions; this kind of image file may be either directly
26         created by a ripping program like readcd(1) or cdrdao(1), or extracted from
27         another image file by nrgtool(1).
29 linkpage:nrgtool[1]::
30         This command reads .nrg images (created by Nero), prints the metadata about
31         the image, and extracts, for each track, the raw data to a separate file.
34 Resources
35 ---------
36 UNIX manual pages that contain usage examples are available for each command.
38 Known bugs and limitations are mentioned in the section about <<bugs, issues>>.
41 // Installation instructions can be found in the file INSTALL
42 include::INSTALL[]
45 // Information about bugs and limitations can be found in the file BUGS
46 include::BUGS[]
49 Credits & License
50 -----------------
51 CDimgtools was written by GĂ©raud Meyer <graud@gmx.com>.
53 CDimgtools is free software; you can redistribute it and/or modify it under the
54 terms of the GNU General Public License version 2 as published by the Free
55 Software Foundation.
57 This package is distributed in the hope that it will be useful, but WITHOUT ANY
58 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
59 PARTICULAR PURPOSE. See the GNU General Public License for more details.
61 The full text of the license can be found in the root directory of the project
62 sources, in the file 'COPYING'.