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 pattern ] [ -c extra_comment ] [ -a artist ] [ -t title ] [ -l album ] [ -G genre ] [ -L lyrics file ] [ -Y language-string ] input_files ...
DESCRIPTION
oggenc reads audio data in either raw, Wave, or AIFF format and encodes it into an Ogg Vorbis stream. oggenc may also read audio data from FLAC and Ogg FLAC files depending upon compile-time options. 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" or ".oga". 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. Optionally, lyrics may be embedded in the Ogg file, if Kate support was compiled in. Note that some old players mail fail to play streams with more than a single Vorbis stream (the so called "Vorbis I" simple profile).
OPTIONS
-h, --help
Show command help.
-V, --version
Show the version number.
-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.
--utf8
Informs oggenc that the Vorbis Comments are already encoded as
UTF-8. Useful in situations where the shell is using some other
encoding.
-k, --skeleton
Add a Skeleton bitstream. Important if the output Ogg is
intended to carry multiplexed or chained streams. Output file
uses .oga as file extension.
--ignorelength
Support for Wave files over 4 GB and stdin data streams.
-Q, --quiet
Quiet mode. No messages are displayed.
-b n, --bitrate=n
Sets target bitrate to n (in kb/s). The encoder will attempt to
encode at approximately this bitrate. By default, this remains a
VBR encoding. See the --managed option to force a managed
bitrate encoding at the selected bitrate.
-m n, --min-bitrate=n
Sets minimum bitrate to n (in kb/s). Enables bitrate management
mode (see --managed).
-M n, --max-bitrate=n
Sets maximum bitrate to n (in kb/s). Enables bitrate management
mode (see --managed).
--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 (very low) and 10 (very
high). This is the default mode of operation, with a default
quality level of 3. Fractional quality levels such as 2.5 are
permitted. Using this option allows the encoder to select an
appropriate bitrate based on your desired quality level.
--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.
--discard-comments
Prevents comments in FLAC and Ogg FLAC files from being copied
to the output Ogg Vorbis file.
-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 %g, %a, %l, %n, %t, %d
replaced by genre, artist, album, track number, title, and date,
respectively (see below for specifying these). Also, %% gives a
literal %.
-X, --name-remove=s
Remove the specified characters from parameters to the -n format
string. This is useful to ensure legal filenames are generated.
-P, --name-replace=s
Replace characters removed by --name-remove with the characters
specified. If this string is shorter than the --name-remove
list, or is not specified, the extra characters are just
removed. The default settings for this option, and the -X option
above, are platform specific (and chosen to ensure legal
filenames are generated for each platform).
-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. The argument should be in the form
"tag=value".
-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.
-L filename, --lyrics filename
Loads lyrics from filename and encodes them into a Kate stream
multiplexed with the Vorbis stream. Lyrics may be in LRC or SRT
format, and should be encoded in UTF-8 or plain ASCII. Other
encodings may be converted using tools such as iconv or recode.
Alternatively, the same system as for comments will be used for
conversion between encodings. So called "enhanced LRC" files
are supported, and a simple karaoke style change will be saved
with the lyrics. For more complex karaoke setups, kateenc(1)
should be used instead. When embedding lyrics, the default
output file extention is ".oga". Note that adding lyrics to a
stream will automatically enable Skeleton (see the -k option for
more information about Skeleton).
-Y language-string, --lyrics-language language-string
Sets the language for the corresponding lyrics file to language-
string. This should be an ISO 639-1 language code (eg, "en"),
or a RFC 3066 language tag (eg, "en_US"), not a free form
language name. Players will typically recognize this standard
tag and display the language name in your own language. Note
that the maximum length of this tag is 15 characters.
Note that the -a, -t, -l, -L, and -Y 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-encode-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.
lowpass_frequency=N
Set the lowpass frequency to N kHz.
impulse_noisetune=N
Set a noise floor bias N (range from -15. to 0.) for impulse
blocks. A negative bias instructs the encoder to pay special
attention to the crispness of transients in the encoded audio.
The tradeoff for better transient response is a higher bitrate.
bitrate_hard_max=N
Set the allowed bitrate maximum for the encoded file to N
kilobits per second. This bitrate may be exceeded only when
there is spare bits in the bit reservoir; if the bit reservoir
is exhausted, frames will be held under this value. This
setting must be used with --managed to have any effect.
bitrate_hard_min=N
Set the allowed bitrate minimum for the encoded file to N
kilobits per second. This bitrate may be underrun only when the
bit reservoir is not full; if the bit reservoir is full, frames
will be held over this value; if it impossible to add bits
constructively, the frame will be padded with zeroes. This
setting must be used with --managed to have any effect.
bit_reservoir_bits=N
Set the total size of the bit reservoir to N bits; the default
size of the reservoir is equal to the nominal number of bits
coded in one second (eg, a nominal 128kbps file will have a bit
reservoir of 128000 bits by default). This option must be used
with --managed to have any effect and affects only minimum and
maximum bitrate management. Average bitrate encoding with no
hard bitrate boundaries does not use a bit reservoir.
bit_reservoir_bias=N
Set the behavior bias of the bit reservoir (range: 0. to 1.).
When set closer to 0, the bitrate manager attempts to hoard bits
for future use in sudden bitrate increases (biasing toward
better transient reproduction). When set closer to 1, the
bitrate manager neglects transients in favor using bits for
homogenous passages. In the middle, the manager uses a balanced
approach. The default setting is .2, thus biasing slightly
toward transient reproduction.
bitrate_average=N
Set the average bitrate for the file to N kilobits per second.
When used without hard minimum or maximum limits, this option
selects reservoirless Average Bit Rate encoding, where the
encoder attempts to perfectly track a desired bitrate, but
imposes no strict momentary fluctuation limits. When used along
with a minimum or maximum limit, the average bitrate still sets
the average overall bitrate of the file, but will work within
the bounds set by the bit reservoir. When the min, max and
average bitrates are identical, oggenc produces Constant Bit
Rate Vorbis data.
bitrate_average_damping=N
Set the reaction time for the average bitrate tracker to N
seconds. This number represents the fastest reaction the
bitrate tracker is allowed to make to hold the bitrate to the
selected average. The faster the reaction time, the less
momentary fluctuation in the bitrate but (generally) the lower
quality the audio output. The slower the reaction time, the
larger the ABR fluctuations, but (generally) the better the
audio. When used along with min or max bitrate limits, this
option directly affects how deep and how quickly the encoder
will dip into its bit reservoir; the higher the number, the more
demand on the bit reservoir.
The setting must be greater than zero and the useful range is
approximately .05 to 10. The default is .75 seconds.
disable_coupling
Disable use of channel coupling for multichannel encoding. At
present, the encoder will normally use channel coupling to
further increase compression with stereo and 5.1 inputs. This
option forces the encoder to encode each channel fully
independently using neither lossy nor lossless coupling.
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 -o out.ogg
Specifying a maximum and average bitrate, and enforcing these:
oggenc infile.wav --managed -b 128 -M 160 -o out.ogg
Specifying quality rather than bitrate (to a very high quality mode):
oggenc infile.wav -q 6 -o out.ogg
Downsampling and downmixing to 11 kHz mono before encoding:
oggenc --resample 11025 --downmix infile.wav -q 1 -o 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 explicitly supported"
Adding embedded lyrics:
oggenc somefile.wav --lyrics lyrics.lrc --lyrics-language en -o
out.oga
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.):
oggenc -
AUTHORS
Program Author:
Michael Smith <msmith@xiph.org>
Manpage Author:
Stan Seibert <indigo@aztec.asu.edu>
BUGS
Reading type 3 Wave files (floating point samples) probably doesn't work other than on Intel (or other 32 bit, little endian machines).
SEE ALSO
vorbiscomment(1), ogg123(1), oggdec(1), flac(1), speexenc(1), ffmpeg2theora(1), kateenc(1)
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
