Difference between revisions of "Oggenc"

From ArchWiki
Jump to: navigation, search
(Command Line)
(16 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 +
[[Category:Audio/Video]]
 
{{Stub}}
 
{{Stub}}
  
Oggenc - encode audio into the Ogg Vorbis format
+
'''Oggenc''' is the official [https://wiki.xiph.org/Vorbis Ogg Vorbis] encoder. It reads audio data in either WAV, FLAC, RAW, or AIFF format and encodes it into an [[Wikipedia:Ogg Vorbis|Ogg Vorbis]] stream. Although [[FFmpeg]] can encode Ogg Vorbis with the {{pkg|libvorbis}} library, it has fewer encoding options and can be considered broken (see: [http://xiphmont.livejournal.com/51160.html Ogg and WebM technical alert]).
  
Oggenc reads audio data in either raw, WAV, or AIFF format and encodes it into an Ogg Vorbis stream. If the input file "-" is specified, audio data is read from stdin and the Vorbis stream is written to stdout unless the -o option is used to redirect the output. By default, disk files are output to Ogg Vorbis files of the same name, with the extension changed to ".ogg". This naming convention can be overridden by the -o option (in the case of one file) or the -n option (in the case of several files). Finally, if none of these are available, the output filename will be the input filename with the extension (that part after the final dot) replaced with ogg, so file.wav will become file.ogg
+
== Installation ==
 +
[[pacman|Install]] the {{pkg|vorbis-tools}} package from the [[Official Repositories|official repositories]] or install a [[Python]] alternative, {{AUR|fastoggenc}}, found in the [[Arch User Repository|AUR]].
  
== Command Line ==
+
== See also ==
 
+
* [https://wiki.xiph.org/Vorbis_Encoders List of Vorbis Encoders] on the Xiph.org Foundation Wiki
SYNOPSIS:
+
* [http://soundconverter.org/ Soundconverter] ([[GTK+]])
oggenc [ -hrQ ] [ -B raw input sample size ] [ -C raw input number of channels ] [ -R raw input samplerate ] [ -b nominal bitrate ] [ -m minimum bitrate ] [ -M maximum bitrate ] [ -q quality ] [ --resample frequency ] [ --downmix ] [ -s serial ] [ -o output_file ] [ -n pattern ] [ -c extra_comment ] [ -a artist ] [ -t title ] [ -l album ] [ -G genre ] input_files ...
+
* [https://launchpad.net/soundkonverter Soundkonverter] ([[Qt]])
 
+
* [[GNOME#Nautilus|Nautilus]] file manager can convert FLAC to Ogg Vorbis
+
* [http://gnormalize.sourceforge.net/ Gnormalize] with {{Pkg|vorbis-tools}}
OPTIONS:
 
Show command help.
 
    -h, --help
 
Assume input data is raw little-endian audio data with no header information. If other options are not specified, defaults to 44.1kHz stereo 16 bit. See next three options for how to change this.     
 
    -r, --raw
 
Sets raw mode input sample size in bits. Default is 16. 
 
    -B n, --raw-bits=n
 
Sets raw mode input number of channels. Default is 2.   
 
    -C n, --raw-chan=n
 
Sets raw mode input samplerate. Default is 44100.   
 
    -R n, --raw-rate=n
 
Sets raw mode endianness to big endian (1) or little endian (0). Default is little endian.   
 
    --raw-endianness n
 
Quiet mode. No messages are displayed.   
 
    -Q, --quiet
 
Sets encoding to the bitrate closest to n (in kb/s).    
 
    -b n, --bitrate=n
 
Sets minimum bitrate to n (in kb/s).    
 
    -m n, --min-bitrate=n
 
Sets maximum bitrate to n (in kb/s).   
 
    -M n, --max-bitrate=n
 
Set bitrate management mode. This turns off the normal VBR encoding, but allows hard or soft bitrate constraints to be enforced by the encoder. This mode is much slower, and may also be lower quality. It is primarily useful for creating files for streaming.   
 
    --managed
 
Sets encoding quality to n, between -1 (low) and 10 (high). This is the default mode of operation, with a default quality level of 3. Fractional quality levels such as 2.5 are permitted. Normal quality range is 0 - 10. 
 
    -q n, --quality=n
 
Resample input to the given sample rate (in Hz) before encoding. Primarily useful for downsampling for lower-bitrate encoding.   
 
    --resample n
 
Downmix input from stereo to mono (has no effect on non-stereo streams). Useful for lower-bitrate encoding.   
 
    --downmix
 
Sets an advanced option. See the Advanced Options section for details.    
 
    --advanced-encode-option optionname=value
 
Forces a specific serial number in the output stream. This is primarily useful for testing.   
 
    -s, --serial
 
Write the Ogg Vorbis stream to output_file (only valid if a single input file is specified)   
 
    -o output_file, --output=output_file
 
Produce filenames as this string, with %a, %t, %l, %G replaced by artist, title, album respectively (see below for specifying these). Also, %% gives a literal %.   
 
    -n pattern, --names=pattern
 
Add the string comment as an extra comment. This may be used multiple times, and all instances will be added to each of the input files specified.
 
    -c comment, --comment comment
 
Set the artist comment field in the comments to artist.   
 
    -a artist, --artist artist
 
Set the genre comment field in the comments to genre.
 
    -G genre, --genre genre
 
Sets the date comment field to the given value. This should be the date of recording.   
 
    -d date, --date date
 
Sets the track number comment field to the given value.   
 
    -N n, --tracknum n
 
Set the track title comment field to title.
 
    -t title, --title title
 
Set the album comment field to album.
 
    -l album, --album album
 
   
 
 
 
Note that the -a, -t, and -l options can be given multiple times. They will be applied, one to each file, in the order given. If there are fewer album, title, or artist comments given than there are input files, oggenc will reuse the final one for the remaining files, and issue a warning in the case of repeated titles.
 
 
 
 
ADVANCED ENCODER OPTIONS:
 
 
 
Oggenc allows you to set a number of advanced encoder options using the --advanced-encoder-option option. These are intended for very advanced users only, and should be approached with caution. They may significantly degrade audio quality if misused. Not all these options are currently documented.
 
 
 
Set the managed bitrate window to NN seconds. The bitrate will be forced to the specified average over a floating window of this length. May be fractional (e.g. 3.5)
 
    bitrate_average_window=NN
 
Set the lowpass frequency to NN kHz.   
 
    lowpass_frequency=NN
 
   
 
 
 
 
EXAMPLES:
 
 
 
Simplest version. Produces output as somefile.ogg:
 
 
 
    oggenc somefile.wav
 
 
 
Specifying an output filename:
 
 
 
    oggenc somefile.wav -o out.ogg
 
 
 
Specifying a high-quality encoding averaging 256 kbps (but still VBR).
 
 
 
    oggenc infile.wav -b 256 out.ogg
 
 
 
Specifying a maximum and average bitrate, and enforcing these.
 
 
 
    oggenc infile.wav --managed -b 128 -M 160 out.ogg
 
 
 
Specifying quality rather than bitrate (to a very high quality mode)
 
 
 
    oggenc infile.wav -q 6 out.ogg
 
 
 
Downsampling and downmixing to 11 kHz mono before encoding.
 
 
 
    oggenc --resample 11025 --downmix infile.wav -q 1 out.ogg
 
 
 
Adding some info about the track:
 
 
 
    oggenc somefile.wav -t "The track title" -a "artist who performed this" -l "name of album" -c "OTHERFIELD=contents of some other field not explictly supported"
 
 
 
This encodes the three files, each with the same artist/album tag, but with different title tags on each one. The string given as an argument to -n is used to generate filenames, as shown in the section above. This example gives filenames like "The Tea Party - Touch.ogg":
 
 
 
    oggenc -b 192 -a "The Tea Party" -l "Triptych" -t "Touch" track01.wav -t "Underground" track02.wav -t "Great Big Lie" track03.wav -n "%a - %t.ogg"
 
 
 
Encoding from stdin, to stdout (you can also use the various tagging options, like -t, -a, -l, etc.):
 
 
 
 
 
 
 
 
 
 
 
Original source: http://linux.about.com/library/cmd/blcmdl1_oggenc.htm
 
 
 
== GUI ==
 
 
 
Nautilus the GNOME file manager can also convert FLAC to Ogg Vorbis.
 

Revision as of 16:37, 23 April 2012

Tango-document-new.pngThis article is a stub.Tango-document-new.png

Notes: please use the first argument of the template to provide more detailed indications. (Discuss in Talk:Oggenc#)

Oggenc is the official Ogg Vorbis encoder. It reads audio data in either WAV, FLAC, RAW, or AIFF format and encodes it into an Ogg Vorbis stream. Although FFmpeg can encode Ogg Vorbis with the libvorbis library, it has fewer encoding options and can be considered broken (see: Ogg and WebM technical alert).

Installation

Install the vorbis-tools package from the official repositories or install a Python alternative, fastoggencAUR, found in the AUR.

See also