redhat man page for oggenc

oggenc(1)							 Vorbis Tools 1.0							 oggenc(1)

NAME
       oggenc - encode audio into the Ogg Vorbis format

SYNOPSIS
       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  pat-
       tern ] [ -c extra_comment ] [ -a artist ] [ -t title ] [ -l album ] [ -G genre ] input_files ...

DESCRIPTION
       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

OPTIONS
       -h, --help
	      Show command help.

       -r, --raw
	      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.

       -B n, --raw-bits=n
	      Sets raw mode input sample size in bits. Default is 16.

       -C n, --raw-chan=n
	      Sets raw mode input number of channels. Default is 2.

       -R n, --raw-rate=n
	      Sets raw mode input samplerate. Default is 44100.

       --raw-endianness n
	      Sets raw mode endianness to big endian (1) or little endian (0). Default is little endian.

       -Q, --quiet
	      Quiet mode.  No messages are displayed.

       -b n, --bitrate=n
	      Sets encoding to the bitrate closest to n (in kb/s).

       -m n, --min-bitrate=n
	      Sets minimum bitrate to n (in kb/s).

       -M n, --max-bitrate=n
	      Sets maximum bitrate to n (in kb/s).

       --managed
	      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.

       -q n, --quality=n
	      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.

       --resample n
	      Resample input to the given sample rate (in Hz) before encoding. Primarily useful for downsampling for lower-bitrate encoding.

       --downmix
	      Downmix input from stereo to mono (has no effect on non-stereo streams). Useful for lower-bitrate encoding.

       --advanced-encode-option optionname=value
	      Sets an advanced option. See the Advanced Options section for details.

       -s, --serial
	      Forces a specific serial number in the output stream. This is primarily useful for testing.

       -o output_file, --output=output_file
	      Write the Ogg Vorbis stream to output_file (only valid if a single input file is specified)

       -n pattern, --names=pattern
	      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 %.

       -c comment, --comment comment
	      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.

       -a artist, --artist artist
	      Set the artist comment field in the comments to artist.

       -G genre, --genre genre
	      Set the genre comment field in the comments to genre.

       -d date, --date date
	      Sets the date comment field to the given value. This should be the date of recording.

       -N n, --tracknum n
	      Sets the track number comment field to the given value.

       -t title, --title title
	      Set the track title comment field to title.

       -l album, --album album
	      Set the album comment field to 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.

       bitrate_average_window=NN
	      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)

       lowpass_frequency=NN
	      Set the lowpass frequency to NN kHz.

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 argu-
       ment 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.):
	      oggenc -

AUTHORS
       Program Author:
	      Michael Smith <msmith@labyrinth.net.au>

       Manpage Author:
	      Stan Seibert <indigo@aztec.asu.edu>

BUGS
       Reading type 3 wav files (floating point samples) probably doesn't work other than on intel (or other 32 bit, little endian machines).

SEE ALSO
       ogg123(1)

								   2002 July 19 							 oggenc(1)