Appendix > Appendix E - OpusEnc encoder command line

OpusEnc encoder, used during the development of this product, is available for download from the following link.

OpusEnc encoder latest build, with full source code, is available for download from its owner's website

Below you can find the full list of command line's options for OpusEnc version 0.1.9:

Usage: opusenc [options] input_file output_file.opus

Encodes input_file using Opus.

It can read the WAV, AIFF, FLAC, Ogg/FLAC, or raw files.

General options:

-h, --help This help

-V, --version Version information

--quiet Quiet mode

input_file can be:

filename.wav file

- stdin

output_file can be:

filename.opus compressed file

- stdout

Encoding options:

--bitrate n.nnn Target bitrate in kbit/sec (6-256/channel)

--vbr Use variable bitrate encoding (default)

--cvbr Use constrained variable bitrate encoding

--hard-cbr Use hard constant bitrate encoding

--comp n Encoding complexity (0-10, default: 10 (slowest))

--framesize n Maximum frame size in milliseconds

(2.5, 5, 10, 20, 40, 60, default: 20)

--expect-loss Percentage packet loss to expect (default: 0)

--downmix-mono Downmix to mono

--downmix-stereo Downmix to stereo (if >2 channels)

--max-delay n Maximum container delay in milliseconds

(0-1000, default: 1000)

Diagnostic options:

--serial n Forces a specific stream serial number

--save-range file Saves check values for every frame to a file

--set-ctl-int x=y Pass the encoder control x with value y (advanced)

Preface with s: to direct the ctl to multistream s

This may be used multiple times

Metadata options:

--comment Add the given string as an extra comment

This may be used multiple times

--artist Author of this track

--title Title for this track

--album Album or collection this track belongs to

--date Date for this track

--genre Genre for this track

--picture Album art for this track

More than one --picture option can be specified.

Either a FILENAME for the picture file or a more

complete SPECIFICATION form can be used. The

SPECIFICATION is a string whose parts are

separated by | (pipe) characters. Some parts may

be left empty to invoke default values. A

FILENAME is just shorthand for "||||FILENAME".

The format of SPECIFICATION is

[TYPE]|[MIME-TYPE]|[DESCRIPTION]|[WIDTHxHEIGHT

xDEPTH[/COLORS]]|FILENAME

TYPE is an optional number from one of:

0: Other

1: 32x32 pixel 'file icon' (PNG only)

2: Other file icon

3: Cover (front)

4: Cover (back)

5: Leaflet page

6: Media (e.g., label side of a CD)

7: Lead artist/lead performer/soloist

8: Artist/performer

9: Conductor

10: Band/Orchestra

11: Composer

12: Lyricist/text writer

13: Recording location

14: During recording

15: During performance

16: Movie/video screen capture

17: A bright colored fish

18: Illustration

19: Band/artist logotype

20: Publisher/studio logotype

The default is 3 (front cover). There may only be

one picture each of type 1 and 2 in a file.

MIME-TYPE is optional. If left blank, it will be

detected from the file. For best compatibility

with players, use pictures with a MIME-TYPE of

image/jpeg or image/png. The MIME-TYPE can also

be --> to mean that FILENAME is actually a URL to

an image, though this use is discouraged. The

file at the URL will not be fetched. The URL

itself is stored in the metadata.

DESCRIPTION is optional. The default is an empty

string.

The next part specifies the resolution and color

information. If the MIME-TYPE is image/jpeg,

image/png, or image/gif, you can usually leave

this empty and they can be detected from the

file. Otherwise, you must specify the width in

pixels, height in pixels, and color depth in

bits-per-pixel. If the image has indexed colors

you should also specify the number of colors

used. If possible, these are checked against the

file for accuracy.

FILENAME is the path to the picture file to be

imported, or the URL if the MIME-TYPE is -->.

--padding n Extra bytes to reserve for metadata (default: 512)

--discard-comments Don't keep metadata when transcoding

--discard-pictures Don't keep pictures when transcoding

Input options:

--raw Raw input

--raw-bits n Set bits/sample for raw input (default: 16)

--raw-rate n Set sampling rate for raw input (default: 48000)

--raw-chan n Set number of channels for raw input (default: 2)

--raw-endianness n 1 for bigendian, 0 for little (defaults to 0)

--ignorelength Always ignore the datalength in Wave headers