isoextract README

isoextract is a program that extracts files from various CD-ROM/DVD-ROM image formats (but due to lack of UDF support, DVD-ROM images may not work), a quick-n-dirty frontend of libmirage and libisofs.

isoextract supports all the format libmirage supports, which are, at the time of writing:

Alcohol 120% (MDS, MDX) image format
Apple disk (DMG, CDR) image format
BlindWrite 5/6 (B5T, B6T) image format
Compressed ISO (CSO) image format
CloneCD (CCD, SUB, IMG) image format
CDRwin (CUE, BIN) image format
Cdrdao’s (TOC, BIN) image format
DiscJuggler (CDI) image format
Easy CD Creator (CIF) image format
Easy Media Creator/WinOnCD (C2D) file format
Error Code Modeller (ECM) container format
gBurner (GBI) image format
GZip (GZ) container format
ISO-9660 (ISO) image format
PowerISO (DAA) image format
Nero Burning ROM (NRG) image format
ReadCD (TOC, BIN) image format
UltraISO’s (ISZ) image format
Universal Disk Format (UDF) image format
XCDRoast (TOC, BIN) image format
Xz (XZ) container format

Dependencies

=libmirage-2*
=glib-2*
libisofs
libpcre
asciidoc, docbook-xml-dtd, etc., if you need to build the man page (build time)
pkg-config (build time)

How to build

# Build program
$ make
# Build docs
$ make docs

Usage

# List all files in /usr/share/virtualbox/VBoxGuestAdditions.iso
isoextract -l -i /usr/share/virtualbox/VBoxGuestAdditions.iso

# Extract all files (but not directories!) directly under the root directory
# and all "Readme*" files under a directory under the root directory to
# /tmp/vbox
isoextract -i /usr/share/virtualbox/VBoxGuestAdditions.iso -o /tmp/vbox -v '/*' '*/Readme*'

# Extract all .dll files within the image, using PCRE regular expressions
isoextract -i /usr/share/virtualbox/VBoxGuestAdditions.iso -o /tmp/vbox -P '.*\.dll'

# List all files that has a segment in path that starts with "ger" in
# "/tmp/tot/Civ II Test of Time.B6T" , using --absolute to deal with the
# incorrect metadata in the image
isoextract -l -i /tmp/tot/Civ\ II\ Test\ of\ Time.B6T --absolute -P '(^|/)ger'

Notes & Limitations

This software is of pre-alpha quality.
Multi-session or MODE-2 disk images probably won’t work. To add support for them I need a test image.
It’s not possible to read image from stdin, because, presumably, random access is required.
Only ISO9660 filesystem is supported presently. UDF isn’t, because I haven’t found a proper library that exposes the driver interface to connect with libmirage. (libcdio does have such a interface, but an internal one.)
I don’t know whether it’s possible to port it to Windows. In particular, I don’t know if libisofs works on Windows.

License