NRGTOOL(1)

💖 NAME 💖

okay so you're reading the NRGTOOL(1) manual, from the CDimg|tools commands corner of the universe, and the whole vibe is: nrgtool reads and converts/splits Nero optical disc image files (.nrg). It's giving disc-image decoder with main character energy, fr fr. 💅

✨ SYNOPSIS ✨

nrgtool { -h | --version }

nrgtool [ -v ] [ -n ] [ -f ] [ -1 ] [ -I ] nrg [ cmd args ]

🌸 DESCRIPTION 🌸

nrgtool processes a NRG disc image file. It finds and parses the IFF footer, which contains the metadata; then it prints information or extracts some data.

Images of all types of discs can be processed; in particular audio CDs (CDDA and CD-extra) and CD-ROM/DVD-ROM (including multi-session discs) have been tested.

A track at position 0 is the lead-in of the session. Tracks of DAO sessions are split at index 1 points.

🎀 COMMANDS 🎀

The default command is info. Periodt.

• help — prints a short usage message.
• info [ chunk_types ] — prints the chunks' structure resulting from parsing the IFF. Flip on verbose mode to view the fields' values.
• hexdump [ chunk_types ] — prints a hexdump for each chunk (of the selected types).
• nop — no op: it only parses the IFF.
• list [ session [ track_pos ] ] — lists the selected tracks. In verbose mode, it gives some track attributes.
• track [ session [ track_pos ] ] — extracts the (raw) data of the selected tracks to files.
• iff — extracts the IFF header to a file.
• types — lists the known chunk types.

💅 OPTIONS 💅

Important little rule, bestie: options can be negated by prefixing them with --no- instead of --.

• --version — prints the version information and exits.
• -h, --help — displays part of the manual.
• -v, --verbose — verbose: prints some or more information, depending on the command. If it is given twice, it also prints debugging information, notably during the parsing.
• -I, --iff — IFF only: processes a bare IFF file previously extracted by the iff command.
• -n, --no-act — No Action: tests the reading of files but does not write any files.
• -f, --force — Force: overwrites existing files.
• -1, --nrgv1 — NRG Version: treats the file as a first version (prior to Nero 5.5) NRG; the default is to treat the file as a version 2 (Nero 5.5 and later). Unimplemented.
• -e, --extension ext — NRG Extension (empty by default): the extension appended to the nrg file name given on the command line to obtain the actual file name used; with this option, the generated files' names can be controlled somewhat.
• -t, --track-ext ext_fmt — Track Extension: printf format template for the tracks' file name extensions (appended to the nrg file name); the first argument to printf is the session number, the second the track number, the third the session number; the default is ".s%02d-t%02d".
• -i, --iff-ext ext — IFF Extension: file name extension of the IFF file (appended to the nrg file name given on the command line); it is ".iff" by default.
• -3, --32 — 32-bit integer mode: if Perl does not have support for 64-bit integers, use this option to parse 64-bit integers as 32-bit (without using the 'Q' template of unpack()). When this option is set, the image size cannot be as large.

🦋 ENVIRONMENT 🦋

No environment variables are used. Not a single one, bestie. 🫶

🍓 EXAMPLES 🍓

To view the result of the parsing:

nrgtool -v image.nrg | less

To show the debugging output of the parsing:

nrgtool -vv image.nrg nop

To view a hexdump of the CD-text chunk:

nrgtool image.nrg hexdump cdtx | less

To list the tracks:

nrgtool image.nrg list

To extract all the audio tracks of image.nrg to image-XX.cdda:

nrgtool -v -e .nrg -t '-%n%02d.cdda' image track 1

To extract a data disc to an iso file image.nrg.iso:

nrgtool -v -t .iso image.nrg track 1 1

If a track contains sub-channel data, you can extract the audio/data with one of the following commands:

raw96cdconv -v image.nrg.s01-t16
raw96cdconv -v --iso image.nrg.s01-t01
raw96cdconv -v --sector-size 2336 image.nrg.s01-t01

An audio track can be converted to WAV by sox(1):

sox -t .cdda -L image.nrg.s01-t16 image-16.wav

💀 BUGS 💀

nrgtool has been tested with images created by Nerolinux 4.0 only. Any resulting incompatibilities with other versions of Nero may be reported to the author.

The NRG version 1 format is not supported because of the lack of sample image files.

If you can reconstruct the same NRG from the extracted files, most probably nrgtool can handle the particular image:

nrgtool image.nrg iff
nrgtool image.nrg track
cat image.nrg.s??-t?? image.nrg.iff >image.nrg.nrgtool
cmp image.nrg image.nrg.nrgtool && echo "nrgtool can extract all the data"

In 32-bit mode, the size of images that can be processed is limited.

See also the CDimg|tools distribution file BUGS.

👑 AUTHOR 👑

G.raud Meyer

🌈 SEE ALSO 🌈

nero(1), raw96cdconv(1), sox(1)

xoxo, CDimg|tools unknown_version · dated 1980-01-01 💖✨