1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
|
.\" Process this file with
.\" groff -man -Tascii opusdec.1
.\"
.TH opusdec 1 2012-08-31 "Xiph.Org Foundation" "opus-tools"
.SH NAME
opusdec \- decode audio in Opus format to Wave or raw PCM
.SH SYNOPSIS
.B opusdec
[
.B -hV
] [
.B --quiet
] [
.B --rate Hz
] [
.B --force-stereo
] [
.B --gain dB
] [
.B --no-dither
] [
.B --float
] [
.B --force-wav
] [
.B --packet-loss pct
] [
.B --save-range file
]
.B input.opus
[
.B output.wav
]
.SH DESCRIPTION
.B opusdec
decodes Opus URLs or files to uncompressed Wave or raw PCM.
In URLs, the
.B file
,
.B http
, and
.B https
schemes are supported unless HTTP support was disabled at build time.
If the input file is specified as
.B "-"
, then
.B opusdec
will read from stdin. Likewise, an output filename of
.B "-"
will cause output to be to stdout.
If no output is specified
.B opusdec
will attempt to play the audio in realtime if it supports
audio playback on your system.
.SH "OPTIONS"
.IP "-h, --help"
Show help message
.IP "-V, --version"
Show version information
.IP "--quiet"
Suppresses program output
.IP "--rate n"
.br
Force decoding at sampling rate n Hz
.IP "--force-stereo"
.br
Force decoding to stereo
.IP "--gain n"
.br
Adjust the output volume n dB, negative values make the signal quieter
.IP "--no-dither"
Do not dither 16-bit output
.IP "--float"
Output 32-bit floating-point samples instead of 16-bit integer samples
.IP "--force-wav"
Force including a Wave header on output (e.g. for non-wav extensions and stdout)
.IP "--packet-loss n"
Simulate n % random Opus packet loss
.IP "--save-range file"
Save check values for every frame to a file
.SH EXAMPLES
Decode a file
.B input.opus
to
.B output.wav
.RS
opusdec input.opus output.wav
.RE
Play a file
.B input.opus
.RS
opusdec input.opus
.RE
Re-encode a high bitrate Opus file to a lower rate
.RS
opusdec --force-wav input.opus - | opusenc --bitrate 64 - output.opus
.RE
Play an http stream
.B http://icecast.somwhere.org:8000/stream.opus
on a system with pulseaudio
.br
.I (press ctrl-c to quit)
.RS
padsp opusdec http://icecast.somwhere.org:8000/stream.opus
.RE
.SH AUTHORS
.br
Jean-Marc Valin <jmvalin@jmvalin.ca>
.br
Gregory Maxwell <greg@xiph.org>
.SH BUGS
Opusdec does not currently reject all invalid files which it should reject.
It also doesn't provide very helpful output for the corrupted files it
does reject. Use \fBopusinfo\fR(1) for somewhat better diagnostics.
.SH SEE ALSO
.BR opusenc (1),
.BR opusinfo (1)
|
