opusdec(1)

1opusdec(1)                        opus-tools                        opusdec(1)
2
3
4

NAME

6       opusdec - decode audio in Opus format to Wave or raw PCM
7
8

SYNOPSIS

10       opusdec  [  -hV ] [ --quiet ] [ --rate Hz ] [ --force-stereo ] [ --gain
11       dB ] [ --no-dither ] [ --float ] [ --force-wav ] [ --packet-loss pct  ]
12       [ --save-range file ] input.opus [ output.wav ]
13
14

DESCRIPTION

16       opusdec decodes Opus URLs or files to uncompressed Wave or raw PCM.
17
18       In  URLs, the file , http , and https schemes are supported unless HTTP
19       support was disabled at build time.
20
21       If the input file is specified as -  ,  then  opusdec  will  read  from
22       stdin.  Likewise,  an  output  filename of - will cause output to be to
23       stdout.
24
25       If no output is specified opusdec will attempt to  play  the  audio  in
26       realtime if it supports audio playback on your system.
27
28

OPTIONS

30       -h, --help
31              Show help message
32
33       -V, --version
34              Show version information
35
36       --quiet
37              Suppresses program output
38
39       --rate n
40              Force decoding at sampling rate n Hz
41
42       --force-stereo
43              Force decoding to stereo
44
45       --gain n
46              Adjust  the  output volume n dB, negative values make the signal
47              quieter
48
49       --no-dither
50              Do not dither 16-bit output
51
52       --float
53              Output 32-bit floating-point samples instead of  16-bit  integer
54              samples
55
56       --force-wav
57              Force including a Wave header on output (e.g. for non-wav exten‐
58              sions and stdout)
59
60       --packet-loss n
61              Simulate n % random Opus packet loss
62
63       --save-range file
64              Save check values for every frame to a file
65
66

EXAMPLES

68       Decode a file input.opus to output.wav
69              opusdec input.opus output.wav
70
71       Play a file input.opus
72              opusdec input.opus
73
74       Re-encode a high bitrate Opus file to a lower rate
75              opusdec --force-wav input.opus - | opusenc --bitrate 64  -  out‐
76              put.opus
77
78       Play  an  http stream http://icecast.somwhere.org:8000/stream.opus on a
79       system with pulseaudio
80       (press ctrl-c to quit)
81              padsp opusdec http://icecast.somwhere.org:8000/stream.opus
82
83

AUTHORS

85       Jean-Marc Valin <jmvalin@jmvalin.ca>
86       Gregory Maxwell <greg@xiph.org>
87
88

BUGS

90       Opusdec does not currently reject all invalid  files  which  it  should
91       reject.   It also doesn't provide very helpful output for the corrupted
92       files it does reject. Use opusinfo(1) for somewhat better diagnostics.
93
94