Appendix B - OggEnc encoder command line
OggEnc encoder, used during the development of this product, is available for download from the following
link.
OggEnc encoder is part of the Vorbis-tools package whose full source code can be downloaded from the
Xiph.org website.
Below you can find the full list of command line's options for OggEnc version 1.0
OggEnc v1.0 (libvorbis 1.0)
(c) 2000-2002 Michael Smith <msmith@labyrinth.net.au>
Usage: oggenc [options] input.wav [...]
OPTIONS:
General:
-Q, --quiet Produce no output to stderr
-h, --help Print this help text
-r, --raw Raw mode. Input files are read directly as PCM data
-B, --raw-bits=n Set bits/sample for raw input. Default is 16
-C, --raw-chan=n Set number of channels for raw input. Default is 2
-R, --raw-rate=n Set samples/sec for raw input. Default is 44100
--raw-endianness 1 for bigendian, 0 for little (defaults to 0)
-b, --bitrate Choose a nominal bitrate to encode at. Attempt
to encode at a bitrate averaging this. Takes an
argument in kbps. This uses the bitrate management
engine, and is not recommended for most users.
See -q, --quality for a better alternative.
-m, --min-bitrate Specify a minimum bitrate (in kbps). Useful for
encoding for a fixed-size channel.
-M, --max-bitrate Specify a maximum bitrate in kbps. Useful for
streaming applications.
-q, --quality Specify quality between 0 (low) and 10 (high),
instead of specifying a particular bitrate.
This is the normal mode of operation.
Fractional qualities (e.g. 2.75) are permitted
Quality -1 is also possible, but may not be of
acceptable quality.
--resample n Resample input data to sampling rate n (Hz)
--downmix Downmix stereo to mono. Only allowed on stereo
input.
-s, --serial Specify a serial number for the stream. If encoding
multiple files, this will be incremented for each
stream after the first.
Naming:
-o, --output=fn Write file to fn (only valid in single-file mode)
-n, --names=string Produce filenames as this string, with %a, %t, %l,
%n, %d replaced by artist, title, album, track number,
and date, respectively (see below for specifying these).
%% gives a literal %.
-X, --name-remove=s Remove the specified characters from parameters to the
-n format string. Useful to ensure legal filenames.
-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.
Default settings for the above two arguments are platform
specific.
-c, --comment=c Add the given string as an extra comment. This may be
used multiple times.
-d, --date Date for track (usually date of performance)
-N, --tracknum Track number for this track
-t, --title Title for this track
-l, --album Name of album
-a, --artist Name of artist
-G, --genre Genre of track
If multiple input files are given, then multiple
instances of the previous five arguments will be used,
in the order they are given. If fewer titles are
specified than files, OggEnc will print a warning, and
reuse the final one for the remaining files. If fewer
track numbers are given, the remaining files will be
unnumbered. For the others, the final tag will be reused
for all others without warning (so you can specify a date
once, for example, and have it used for all the files)
INPUT FILES:
OggEnc input files must currently be 16 or 8 bit PCM WAV, AIFF, or AIFF/C
files, or 32 bit IEEE floating point WAV. Files may be mono or stereo
(or more channels) and any sample rate.
Alternatively, the --raw option may be used to use a raw PCM data file, which
must be 16bit stereo little-endian PCM ('headerless wav'), unless additional
parameters for raw mode are specified.
You can specify taking the file from stdin by using - as the input filename.
In this mode, output is to stdout unless an outfile filename is specified
with -o
