README for miragextract v0.0.1
==============================

Description
-----------
Extracts data and audio tracks from any CD image supported by libmirage.
Data tracks are written as-is, and audio tracks can be written as-is
or converted to wav, flag, or ogg/vorbis (via libsndfile).

Installing
----------
Requires GNU make, libmirage >= 3.0.0 and libsndfile (tested with 1.0.26,
other recent-ish versions should work).

To build, run "make" or "gmake". There is no "make install", just copy the
miragextract binary to /usr/local/bin and the man page (miragextract.1)
to /usr/local/share/man/man1, or whatever paths make sense on your OS.
There's also a miragextract.html, if you prefer your documentation
that way.

Supported formats
-----------------
According to the README from libmirage-3.2.4:

> Currently supported image formats:
>  - BlindWrite 5/6 (B5T, B6T) file format (readonly)
>  - Roxio / WinOnCD (C2D) file format (readonly)
>  - CloneCD (CCD, SUB, IMG) image format (readonly)
>  - DiscJuggler (CDI) file format (readonly)
>  - Easy CD Creator (CIF) file format (readonly)
>  - CDRwin (CUE, BIN) image format (readonly)
>  - Raw track loader (ISO, UDF etc.) image format (read-write)
>  - Alcohol 120% (MDS) image format (readonly)
>  - Daemon Tools (MDX) image format (readonly)
>  - Nero Burning ROM (NRG) image format (readonly)
>  - ReadCD (TOC, BIN) image format (readonly)
>  - Cdrdao's (TOC, BIN) image format (read-write)
>  - XCDRoast (TOC, BIN) image format (readonly)

> Currently supported filter streams:
>  - Apple Disk Image (DMG) container format (readonly)
>  - Apple Disk Image (IMG, SMI) via MacBinary container format (readonly)
>  - GZip (GZ) container format (readonly)
>  - XZ (XZ) container format (readonly)
>  - Compressed ISO (CSO) container format (readonly)
>  - Compressed ISO (ISZ) container format (readonly)
>  - Error Code Modeller (ECM) container format (readonly)
>  - PowerISO (DAA) image format (readonly)
>  - SNDFILE audio files (read-write)

Not all these formats have been tested with miragextract. I have tested
bin/cue (both single-bin and multi-bin), mds, ecm, nrg, and ccd as of
this writing, and all work fine.

Author and Copyright
--------------------
miragextract was written by B. Watson <yalchru@gmail.com>, and is released
under the WTFPL: Do WTF you want with this.

Support
-------
None guaranteed. If you run into problems, first try the latest code
from git, which you can find at:

http://urchlay.naptime.net/repos/miragextract/

If this doesn't help, contact me by email (see above) and I'll see what
I can do.