Nero AAC: Difference between revisions

From Hydrogenaudio Knowledgebase
(version information)
Line 6: Line 6:
| caption =  
| caption =  
| maintainer = Nero AG
| maintainer = Nero AG
| stable_release = 1.5.4.0 (Feb 18. 2010)
| stable_release = [[#Versions|See table]]
| preview_release = n/a
| preview_release = n/a
| operating_system = Windows, Linux
| operating_system = Windows, Linux
Line 18: Line 18:
It is generally percieved to have the highest quality [[VBR]] LC AAC implementation (although QuickTime bests it in [[CBR]] mode at 128kbps). The codec can also create HEv1/v2 AAC streams for extremely low bitrates and supports multi-channel surround sound encoding.
It is generally percieved to have the highest quality [[VBR]] LC AAC implementation (although QuickTime bests it in [[CBR]] mode at 128kbps). The codec can also create HEv1/v2 AAC streams for extremely low bitrates and supports multi-channel surround sound encoding.


The three command-line tools are:
== Versions ==
* neroAacEnc
* neroAacDec
* neroAacTag


The suite comes with three command line tools.
{| class="wikitable"
! Tool !! Role !! Latest Version
|-
| [[#neroAacEnc|neroAacEnc]] || AAC encoder || 1.5.4.0 (Feb 18 2010)
|-
| [[#neroAacDec|neroAacDec]] || AAC decoder || 1.5.1.0 (Dec 17 2009)
|-
| [[#neroAacTag|neroAacTag]] || MP4 metadata editor || 1.5.1.0 (Dec 17 2009)
|}


== NeroAacEnc ==
== NeroAacEnc ==

Revision as of 05:04, 23 July 2014


Nero AAC Codec

Developer(s) Nero AG
Release information
Initial release {{{released}}}
Stable release See table
Preview release n/a
Compatibility
Operating system Windows, Linux
Additional information
Use Encoder/Decoder
License see site for license
Website Nero AAC Codec

The Nero AAC codec has been made freely available by Nero AG for personal non-commercial and/or technology-evaluation purposes. It is a commercial implementation of both LC AAC and HE AAC and provided as a set of three command-line tools that are used to encode, decode and apply tags to MP4 files. The download contains binaries for both Windows and Linux. It is the same codec that is used in Nero's other, commercial products.

It is generally percieved to have the highest quality VBR LC AAC implementation (although QuickTime bests it in CBR mode at 128kbps). The codec can also create HEv1/v2 AAC streams for extremely low bitrates and supports multi-channel surround sound encoding.

Versions

The suite comes with three command line tools.

Tool Role Latest Version
neroAacEnc AAC encoder 1.5.4.0 (Feb 18 2010)
neroAacDec AAC decoder 1.5.1.0 (Dec 17 2009)
neroAacTag MP4 metadata editor 1.5.1.0 (Dec 17 2009)

NeroAacEnc

This is the encoder command-line tool. It is currently at version 1.5.4.0 and was last updated Feb 18th, 2010. It is used to encode a .WAV file containing PCM data into an .MP4 file containing an AAC stream.

Usage

Windows

neroAacEnc.exe [options] -if <input-file> -of <output-file>

Linux:

./neroAacEnc [options] -if <input-file> -of <output-file>

Note: Make sure the binary is executable

Where:

<input-file>
Path to source file to encode.
The file must be in Microsoft WAV format and contain PCM data.
Specify - to encode from stdin.
Note that multiple input files can be specified, they will be encoded together into a single output file with chapter marks indicating source file divisions.
<output-file>
Path to output file to encode to, in MP4 format.

Options:

Quality/bitrate control
-q <number>
Enables "target quality" mode. (VBR)
<number> is a floating-point number in 0...1 range. I.e. 0.5 or 0.75, etc. with 1 being the highest quality and thus also having the largest output file size.
-br <number>
Specifies "target bitrate" mode. (ABR)
<number> is target bitrate in bits per second ranging from 8000 to 400000.
-cbr <number>
Specifies "target bitrate (streaming)" mode. (CBR)
<number> is target bitrate in bits per second ranging from 8000 to 400000.

When neither of above quality/bitrate options is used, the encoder defaults to equivalent of -q 0.5

The following VBR quality settings result in the following average bitrates:

Quality Bitrate (kbit/s)
0.05 16
0.15 33
0.25 66
0.35 100
0.45 146
0.55 192
0.65 238
0.75 285
0.85 332
0.95 381
Multipass encoding
-2pass
Enables two-pass encoding mode.
Note that two-pass mode requires a physical file as input, rather than stdin.
Using two-pass encoding is not recommended when using VBR.
-2passperiod <number>
Overrides two-pass encoding bitrate averaging period, in milliseconds.
Specify zero to use least restrictive value possible (default).
Advanced features / troubleshooting
-lc
Forces use of LC AAC profile (HE features disabled). (LC = Low Complexity)
-he
Forces use of HE AAC profile (HEv2 features disabled). (HE = High Efficiency)
-hev2
Forces use of HEv2 AAC profile

Note that the above switches (-lc, -he, -hev2) are not required and should normally not be used. The optimal AAC profile is automatically determined from quality/bitrate settings when no override is specified. A scenario where using the switches might be useful is to force LC when you have a device that doesn’t support HE.

-ignorelength
Ignores length signaled by WAV headers of input file. Useful for certain frontends using stdin.

NeroAacDec

NeroAacDec is the command-line decoder. It is currently at version 1.5.1.0 and was last updated Dec 17th, 2009. It decodes an .MP4 file into a .WAV file

Usage

Windows:

neroAacDec.exe -if <input file> -of <output file> [-chapter <number>]

Where:

<input-file>
Path of source input file to decode, in MP4 format.
<output-file>
Path to decode the file to, in WAV format.
Specify - to decode to stdout.

Options

-chapter <number>
Specify the chapter mark within the input MP4 file.

NeroAacTag

NeroAacTag is used to list or edit an MP4 file's meta-data. It is currently at version 1.5.1.0 and was last updated Dec 17th, 2009. By default is writes iTunes-compatible tags.

Usage

Windows:

neroAacTag.exe <file.mp4> <command> [<command> [<command> ...]]

Available commands

-list-meta
Lists existing metadata entries.
-meta:<name>=<value>
Sets specified metadata field to specified value. Eg. -meta:artist="Pink Floyd"
-meta-user:<name>=<value>
Sets specified metadata field to specified value. Allows non-standard metadata fields to be added.
WARNING: fields added using -meta-user are not guaranteed to be read back on all Nero Digital compliant software/hardware.
-list-standard-meta
Displays a list of field names usable with -meta command.
-list-standard-itunes-meta
Displays a list of iTunes field names. (Usable with -meta-user)
-list-standard-memorystick-meta
Displays a list of iTunes field names.
-list-covers
Lists cover art entries.
-write-nd-covers
Write cover art also to ND tags. Default is to write only to iTunes tags.
-add-cover:<type>:<jpegfile>
Creates a cover art entry from specified JPEG file. <type> specifies type of cover art entry and can be "front" or "back". If specified cover art entry already exists, its contents are overwritten. Eg. -add-cover:back:hello.jpg
-dump-cover:<type>:<jpegfile>
Dumps specified cover art entry contents to a JPEG file.
-remove-cover:<type>
Removes specified cover art entry.
-remove-cover:all
Removes all cover art entries.
-list-chapters
Lists chapters present in the file.
-chapter:<number>
Sets chapter index metadata edits apply to. Value of 0 (default state) applies edits to all present chapters. Also affects -list-meta output.
-chapters-to-tracknumbers
Generates track number metadata according to the chapter list.

Supported metadata fields

Strings are all encoded in utf8.

Tag name Usage MP4 block modified Comment
title -meta:title=<string> ©nam
artist -meta:artist=<string> ©ART
year -meta:year=<string> ©day Block actually supports full YYYY-MM-DD
album -meta:album=<string> ©alb
genre -meta:genre=<string> ©gen This is the "User-defined" genre as opposed to the gnre block that stores ID3 integer genres
track -meta:track=<int> trkn Block stores both track and totaltracks in one binary value
totaltracks -meta:totaltracks=<int> trkn Block stores both track and totaltracks in one binary value
disc -meta:disc=<int> disk Block stores both disc and totaldiscs in one binary value
totaldiscs -meta:totaldiscs=<int> disk Block stores both disc and totaldiscs in one binary value
url -meta:url=<string>
copyright -meta:copyright=<string>
comment -meta:comment=<string>
lyrics -meta:lyrics=<string>
credits -meta:credits=<string>
rating -meta:rating=<?>
label -meta:label=<string>
composer -meta:composer=<string>
isrc -meta:isrc=<?>
mood -meta:mood=<?>
tempo -meta:tempo=<int> tmpo Beats per minute, stored as a 16-bit integer
writer -meta-user:writer=<string>
contentgroup -meta-user:contentgroup=<string>
album artist -meta-user:'album artist'=<string> aART
description -meta-user:description=<string>
network -meta-user:network=<string>
show -meta-user:show=<string>
season -meta-user:season=<int>
episode -meta-user:episode=<int>
episodename -meta-user:episodename=<string>
sorttitle -meta-user:sorttitle=<string>
sortalbum -meta-user:sortalbum=<string>
sortartist -meta-user:sortartist=<string>
sortband -meta-user:sortband=<string>
sortwriter -meta-user:sortwriter=<string>
sortshow -meta-user:sortshow=<string>
itunescompilation -meta-user:itunescompilation=<0,1> cpil iTunes only. More common to use something like "Various Artists" in the Album Artist field
itunespodcast -meta-user:itunespodcast=<string>

Notes

neroAacTag has a bug. Meta tag values that contain one or more semi-colons (;) will get split up into multiples of that tag.

For example, you run the following command:

neroAacTag test.m4a -meta:artist="Artist A; Artist B; Artist C"

Instead of having a single artist tag listing all three artists (artist="Artist A; Artist B; Artist C"), you get three artist tags with an artist listed in each (artist="Artist A" artist=" Artist B" artist=" Artist C").

neroAacTag will show your tag as correctly applied but iTunes or Mp3tag will not see that. (Mp3tag will show you the duplicate tags in the Extended tags view.)

Example EAC Settings

The following settings are examples of what one might use for music and spoken word sources, respectively. Files will be tagged properly using these commands via neroaactag.exe. These commands do run ReplayGain on the files.

This is the syntax for older versions of EAC. For 1.0 beta 2 and above, variables have a changed syntax. See [[1]]

320kbps CBR AAC (Forced LC)

Program, including path, used for compression: C:\Windows\system32\cmd.exe
Additional Command Line Options: /c ""C:\path\to\neroaacenc.exe" -cbr 320000 -lc -if %s -of %d && "C:\path\to\Neroaactag.exe" %d -meta:artist="%a" -meta:album="%g" -meta:track="%n" -meta:title="%t" -meta:genre="%m" -meta:year="%y""

Q0.3 VBR AAC (Forced HE)

Program, including path, used for compression: C:\Windows\system32\cmd.exe
Additional Command Line Options: /c ""C:\Program Files\Exact Audio Copy\neroaacenc.exe" -q 0.3 -he -if %s -of %d && "C:\Program Files\Exact Audio Copy\Neroaactag.exe" %d -meta:artist="%a" -meta:album="%g" -meta:track="%n" -meta:title="%t" -meta:genre="%m" -meta:year="%y""

Nero AAC in Foobar

The Nero AAC Codec can be used inside Foobar2000's convert function.

References

Recommended Settings Sticky

Discussion Thread for the Recommended Setting Sticky