| Manual section: | 1 |
|---|---|
| Manual group: | Urchlay |
| Date: | 2020-05-07 |
| Version: | 0.0.1 |
miragextract [-l] [-s] [-t track] [-b base] [-f fmt] [-q quality ] image-file
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, flac, or ogg/vorbis (via libsndfile).
| --help | Print short usage string. |
| -l | Lists the tracks in the image without extracting them. |
| -a | Extract only audio tracks. |
| -d | Extract only data tracks. |
| -s | Swaps bytes in audio tracks. Use this if your audio files sound like white noise or gibberish. |
| -t | Takes a track number (1-99), and extracts only that one track. Default behaviour is to extract all tracks. |
| -b | Sets the base filename for the output files. Default is 'track'. 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. |
| -n | Set the base filename to the input filename, minus its extension. E.g. for foo.cue, this is the same as saying "-b foo". Beware of 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. |
| -f | Sets the format and filename extension for the output files. Choices are wav, ogg, flac, cdda (raw CD audio). Default is wav. |
| -q | 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. |
Always include a space between an option and its argument (e.g. -b foo, not -bfoo).
Image-file is e.g. a .cue, .ccd, .nrg, .mds, or anything else supported by libmirage. See the README for your version of libmirage for details.
Output files will be overwritten if they already exist, with no prompting.
Output audio files are named track01.wav, track02.wav, etc by default. The 'track' part of the name can be set with -b, and the extension will 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.
Output data tracks will be named to end in '.iso', which is usually correct. Future versions of this program might be smart enough to detect e.g. Macintosh DMG files and name them appropriately (for now, just rename them if you need to).
Images with multiple sessions should be supported, but have not been tested. Track numbering just continues, so a disc with 2 sessions of 8 files each will have tracks numbered 1 to 16 as far as the -t option and the output filenames are concerned.
When extracting raw CD audio tracks, you can test them by listening to them with the play command from sox. Try:
play -x -t cdda track01.cdda
...possibly without the -x option if you're on a big-endian platform.
As usual, 0 for success, non-zero for failure.
There's not enough error checking. It's probably possible to make miragextract segfault under some circumstances.
miragextract was written by B. Watson <yalhcru@gmail.com> and released under the WTFPL: Do WTF you want with this.
TODO: fill in