Unix/Linux Go Back    

RedHat 9 (Linux i386) - man page for oggenc (redhat section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)

oggenc(1)				 Vorbis Tools 1.0				oggenc(1)

       oggenc - encode audio into the Ogg Vorbis format

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

       oggenc reads audio data in either raw, WAV, or AIFF format and encodes it into an Ogg Vor-
       bis 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

       -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

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

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

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

       -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  record-

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

       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.

	      Set the lowpass frequency to NN kHz.

       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 file-
       names, as shown in the section above. This example gives filenames like "The Tea  Party	-
	      oggenc  -b  192  -a "The Tea Party" -l "Triptych" -t "Touch" track01.wav -t "Under-
	      ground" 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 -

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

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

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


					   2002 July 19 				oggenc(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums

All times are GMT -4. The time now is 11:35 PM.