aboutsummaryrefslogtreecommitdiff
path: root/miragextract.1
diff options
context:
space:
mode:
Diffstat (limited to 'miragextract.1')
-rw-r--r--miragextract.120
1 files changed, 11 insertions, 9 deletions
diff --git a/miragextract.1 b/miragextract.1
index 15571cd..5054312 100644
--- a/miragextract.1
+++ b/miragextract.1
@@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
-.TH MIRAGEXTRACT 1 "2020-05-09" "0.1.0" "Urchlay"
+.TH MIRAGEXTRACT 1 "2020-05-12" "0.1.0" "Urchlay"
.SH NAME
miragextract \- extract audio and data tracks from CD images
.
@@ -57,8 +57,8 @@ Print short usage string.
.B \-a
Extract only audio tracks. Default is to extract all tracks.
.TP
-.B \-b
-Sets the base filename for the output files. Default is \(aqtrack\(aq.
+.BI \-b \ <name>
+Sets the base filename for the output files. Default is \fBtrack\fP\&.
Can be prefixed with a directory to write files in that dir,
but the dir must already exist (example: \-b extracted/track). See
also the \-n option.
@@ -68,7 +68,8 @@ Extract only data tracks. Default is to extract all tracks.
.TP
.B \-f
Sets the format and filename extension for the output audio files.
-Choices are \fBwav\fP, \fBogg\fP, \fBflac\fP, \fBcdda\fP (raw CD audio). Default is \fBwav\fP\&.
+Choices are \fBwav\fP, \fBogg\fP, \fBflac\fP, \fBcdda\fP (raw CD audio).
+Default is \fBwav\fP\&.
.TP
.B \-l
Lists the tracks in the image without extracting them.
@@ -80,13 +81,13 @@ using input filenames with directory separators in them: the output files
will be written in the same dir as the input file. Hopefully you
have permission to write there.
.TP
-.B \-p
+.BI \-p \ <passwd>
Password for encrypted images. Note that anyone who can run \fBps(1)\fP
on your system may be able to view the password. Also note that password
support in miragextract is \fIcompletely\fP untested: I have no
encrypted images to test with.
.TP
-.B \-q
+.BI \-q \ <qual>
Quality setting for ogg and flac output files. Integer from 0
to 10. Default is 7. Has very little effect on flac, and no effect on
wav or cdda output.
@@ -95,7 +96,7 @@ wav or cdda output.
Swaps bytes in audio tracks. Use this if your audio files sound
like white noise or gibberish.
.TP
-.B \-t
+.BI \-t \ <track>
Takes a track number (1\-99), and extracts only that one track.
Default behaviour is to extract all tracks.
.UNINDENT
@@ -114,8 +115,9 @@ match the encoding set with \-f. Note that mp3 is NOT a valid \-f option.
If you need mp3, extract to .wav and then use a tool like lame or ffmpeg
to convert to mp3.
.sp
-Output data tracks will be named to end in \(aq.iso\(aq, or \(aq.dmg\(aq if they look
-like Apple disk images.
+Output data tracks will be named to end in \(aq.iso\(aq by default, or \(aq.hfs\(aq
+if they look like Apple disk images, or \(aq.hfs.iso\(aq for "hybrid" images
+that can be mounted as either (such as Blizzard\(aqs Mac/PC releases).
.sp
Images with multiple sessions should be supported, but have not been
tested. Track numbering just continues, so a disc with 2 sessions of