SourceForge has been redesigned. Learn more.

Tree [d995e5] master current upstream/release_0_80 /

HTTPS access

File Date Author Commit
 MSVC 2005-10-05 rocky rocky [16bdbf] Remove libpopt.
 doc 2008-03-15 rocky rocky [d995e5] Update for doxygen 1.5.3
 example 2008-03-15 rocky rocky [691d64] More libiconv escallation. Sigh.
 include 2008-03-08 rocky rocky [40fe8b] Things needed to make "make distcheck" work.
 lib 2008-03-04 rocky rocky [aeadea] Comment typo
 misc 2003-04-29 rocky rocky [ffa410] Gentoo ebuild file courtesy of Kris Verbeeck <k...
 package 2006-03-28 rocky rocky [ec577b] README
 parse 2005-10-27 rocky rocky [f24ea4] Lex/Flex cdrdao TOC scanner
 src 2008-03-15 rocky rocky [691d64] More libiconv escallation. Sigh.
 test 2008-03-15 rocky rocky [691d64] More libiconv escallation. Sigh.
 .cvsignore 2006-03-07 rocky rocky [926254] .
 AUTHORS 2008-01-18 rocky rocky [3dc711] email address change.
 INSTALL 2007-10-27 rocky rocky [83fb59] Final 0.79 release 2008-03-15 rocky rocky [7b32c1] Install pkgconfig files libudf.pc, libcdio++.pc...
 NEWS 2008-03-15 rocky rocky [2b42b3] Revise before release.
 README 2006-03-28 rocky rocky [a2ebe5] README
 README.libcdio 2006-03-18 rocky rocky [df4da9] Update instructions
 THANKS 2008-02-29 rocky rocky [5f1027] Add option to cd-paranoia to log summary output...
 TODO 2005-07-11 rocky rocky [825872] Reorder and revise 2008-03-09 rocky rocky [adf1b9] Try to undo the damage gettextize does on confi... 2008-03-15 rocky rocky [6dcb2f] Assume darwin9 is like darwin8.
 cvs2cl_header 2004-02-21 rocky rocky [449bbc] Add header for ChangeLog file.
 cvs2cl_usermap 2006-03-14 rocky rocky [379612] Remove email addresses -- spammers are winning 2006-03-06 rocky rocky [6ed9b4] Distribute pkg-config files. Add iso9600.hpp to... 2006-08-20 rocky rocky [9cd49d] Patches from Steve Schultz to handle libiconv i... 2005-09-22 rocky rocky [b7c71f] Reinstate -lm in libcdio_cdda.pc 2005-09-22 rocky rocky [e21c6a] libcdio_paranoia and libcdio_cdda need to inclu... 2006-03-06 rocky rocky [6ed9b4] Distribute pkg-config files. Add iso9600.hpp to... 2005-09-22 rocky rocky [d51ff8] Needs libcdio library. 2005-10-17 rocky rocky [273204] Standard dance for pkg-config and libudf.

Read Me

See README.libcdio for installation instructions.

The libcdio package contains a library for CD-ROM and CD image
access. Applications wishing to be oblivious of the OS- and
device-dependent properties of a CD-ROM or of the specific details of
various CD-image formats may benefit from using this library.

A library for working with ISO-9660 filesystems libiso9660 is
included. A generic interface for issuing MMC (multimedia commands) is
also part of the libcdio library.

Also included is a library for working with ISO-9660 filesystems as is
also the CD-DA error/jitter correction library from cdparanoia

Some support for disk image types like CDRWin's BIN/CUE format,
cdrdao's TOC format, and Nero's NRG format are available. Therefore,
applications that use this library also have the ability to read disc
images as though they were CD's.

The library is written in C, however there are OO C++, Perl, Python
and Ruby wrappers to interface to the library. However C++ is the only
one that is bundled with this package, and the interfaces provide only
a subset of the full features of the library.

Also included in the libcdio package are a number of utility programs:

* cd-info  - displays CD information: number of tracks, CD-format and 
	     if possible basic information about the format.  If libcddb
             ( is available, the cd-info
             program will display CDDB matches on CD-DA discs. And if a
             new enough version of libvcdinfo is available (from the
	     vcdimager project), then cd-info shows basic VCD information.

* cd-read  - performs low-level block reading of a CD or CD image, 

* iso-info - displays ISO-9660 information from an ISO-9660 image, 

* iso-read - extracting files from an ISO-9660 image, a version of the
             CD-DA extraction tool cdparanoia which corrects for
             CD-ROM jitter, and a simple curses-based CD player,
             cdda-player using the analog CD-ROM output.

* cd-paranoia - port of cdparanoia (CD-DA jitter and error correction)
                using libcdio back-end CD-reading. 

At present, there is no support for writing CD's, nor is there any
support for reading or writing DVDs. For some of these, there are
other libraries (e.g. libdi, libscg, or libdvdread) may be helpful.

Some of the projects using libcdio are the Video CD authoring and
ripping tools VCDImager (, a navigation-capable
Video CD plugin and CD-DA plugins for the media players xine
(, videolan's vlc (, media
players mplayerxp ( and gmerlin
(, kiso, a KDE GUI for creating,
extracting and editing ISO-9600 images (,
and a Samba vfs module that allows exporting a CD without mounting it

$Id: README,v 1.13 2006/03/28 14:48:44 rocky Exp $