|
|
@ -1,50 +1,68 @@ |
|
|
|
NRGrip - extract audio data and cue sheet from an NRG audio CD image |
|
|
|
==================================================================== |
|
|
|
nrgrip(1) - rip Nero Burning ROM audio NRG images |
|
|
|
================================================= |
|
|
|
|
|
|
|
This program works on a Nero Burning ROM's NRG image of an audio CD and is able |
|
|
|
to: |
|
|
|
SYNOPSIS |
|
|
|
-------- |
|
|
|
|
|
|
|
- read and display its metadata; |
|
|
|
`nrgrip` [-icrx] [options] <image.nrg> |
|
|
|
|
|
|
|
- extract the cue sheet; |
|
|
|
`nrgrip` [-h | -V] |
|
|
|
|
|
|
|
- extract the raw audio tracks as one single file, which can then be encoded by |
|
|
|
DESCRIPTION |
|
|
|
----------- |
|
|
|
|
|
|
|
NRGrip works on a Nero Burning ROM's NRG image of an audio CD and is able to: |
|
|
|
|
|
|
|
* read and display its metadata; |
|
|
|
|
|
|
|
* extract the cue sheet; |
|
|
|
|
|
|
|
* extract the raw audio tracks as one single file, which can then be encoded by |
|
|
|
the user to a more convenient audio format such as FLAC, and possibly split |
|
|
|
according to the cue sheet. |
|
|
|
|
|
|
|
For now, only NRG v2 is handled (not NRG v1), and not all of the metadata chunks |
|
|
|
are decoded. If you have interest in adding support for additional chunks or |
|
|
|
formats and have a test image handy, please contact the author or open a |
|
|
|
ticket. In particular, it would be interesting to support ISRC/CD-Text; handling |
|
|
|
formats and have a test image handy, please contact the author or open an |
|
|
|
issue. In particular, it would be interesting to support ISRC/CD-Text; handling |
|
|
|
of multisession and hybrid (audio and data) discs would also be a nice feature. |
|
|
|
|
|
|
|
NRGrip is licensed under the terms of the Expat (MIT) license. See the `COPYING` |
|
|
|
file. |
|
|
|
OPTIONS |
|
|
|
------- |
|
|
|
|
|
|
|
At least one action switch must be provided, along with any number of option |
|
|
|
switches. |
|
|
|
|
|
|
|
Installing |
|
|
|
---------- |
|
|
|
### Actions |
|
|
|
|
|
|
|
NRGrip is written in Rust. Make sure [Cargo](http://doc.crates.io/) is installed |
|
|
|
on your system, then: |
|
|
|
* `-i`, `--info`: |
|
|
|
display the NRG image metadata (default action) |
|
|
|
|
|
|
|
cargo build --release |
|
|
|
cargo install |
|
|
|
* `-c`, `--extract-cue`: |
|
|
|
extract cue sheet from the NRG metadata |
|
|
|
|
|
|
|
* `-r`, `--extract-raw`: |
|
|
|
extract the raw audio tracks |
|
|
|
|
|
|
|
* `-x`, `--extract`: |
|
|
|
same as `-cr` |
|
|
|
|
|
|
|
Usage |
|
|
|
----- |
|
|
|
### Additional options |
|
|
|
|
|
|
|
To see the full usage, run: |
|
|
|
* `-S`, `--no-strip-subchannel`: |
|
|
|
don't strip the 96-bit subchannel from the extracted audio data (this option |
|
|
|
has no effect if the input image has standard 2352-byte sector size) |
|
|
|
|
|
|
|
nrgrip --help |
|
|
|
EXAMPLE |
|
|
|
------- |
|
|
|
|
|
|
|
Basically, you can display the metadata and extract the data with: |
|
|
|
The following command will display the metadata and extract both the cue sheet |
|
|
|
and the audio data: |
|
|
|
|
|
|
|
nrgrip -ix image.nrg |
|
|
|
|
|
|
|
The cue sheet will be extracted as `image.cue`, and the audio data as |
|
|
|
`image.raw`. |
|
|
|
`image.raw` in the current directory. |
|
|
|
|
|
|
|
The raw audio data from a CD is 16 bit, little endian, 44100 Hz, stereo. To |
|
|
|
play it, you may use, for instance, `aplay` from the ALSA utils, or `ffplay` |
|
|
@ -70,3 +88,32 @@ To split the FLAC file according to the cue sheet, you may use, |
|
|
|
Or [mp3splt](http://mp3splt.sourceforge.net/): |
|
|
|
|
|
|
|
mp3splt -c image.cue image.flac |
|
|
|
|
|
|
|
INSTALLATION |
|
|
|
------------ |
|
|
|
|
|
|
|
NRGrip is written in Rust. Make sure [Cargo](http://doc.crates.io/) is installed |
|
|
|
on your system, then you can install directly from the Git repository with: |
|
|
|
|
|
|
|
cargo install --git https://code.lm7.fr/mcy/nrgrip.git |
|
|
|
|
|
|
|
Or if you cloned the repository already: |
|
|
|
|
|
|
|
cargo build --release |
|
|
|
cargo install |
|
|
|
|
|
|
|
You may also generate the manpage with: |
|
|
|
|
|
|
|
make |
|
|
|
|
|
|
|
COPYRIGHT |
|
|
|
--------- |
|
|
|
|
|
|
|
NRGrip was written by Matteo Cypriani <<mcy@lm7.fr>> and is licensed under the |
|
|
|
terms of the Expat (MIT) license. See the [COPYING](COPYING) file. |
|
|
|
|
|
|
|
SEE ALSO |
|
|
|
-------- |
|
|
|
|
|
|
|
Additional information can be found on |
|
|
|
[NRGrip's wiki](https://code.lm7.fr/mcy/nrgrip/wiki). |