aboutsummaryrefslogtreecommitdiff
path: root/README
blob: 6369c035a6cf9dbea7e6fee7edb00bb133eb5821 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
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" (might be spelled "gmake" on your OS). To install,
"make install". Near the top of the Makefile are some variables you
can override on the make command line to control where everything gets
installed.

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.