Copyright © 2008-2018 MultiMedia Soft

Appendix B - OggEnc encoder command line

Previous pageReturn to chapter overviewNext page

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