opusdec(1)							    opus-tools								opusdec(1)

NAME

       opusdec - decode audio from Opus format to WAV (or simple audio output)

SYNOPSIS

       opusdec [ -hv ] [ --mono ] [ --stereo ] [ --rate Hz ] [ --no-dither ] [ --packet-loss pct ] [ --save-range file ] input.opus [ output.wav ]

DESCRIPTION

       opusdec decodes Opus files into PCM Wave (uncompressed) files.

       If  the input file is specified as - , then opusdec will read from stdin. Likewise, an output filename of - will cause output to be to std-
       out.

       If no output is specified opusdec will attempt to play the audio in realtime if it supports audio playback on your system.

OPTIONS

       -h, --help
	      Print help message

       -v, --version
	      Display version information

       --quiet
	      Suppresses program output

       --mono
	      Force decoding in mono

       --stereo
	      Force decoding in stereo

       --rate
	      Force decoding at sampling rate n Hz

       --no-dither
	      Do not dither 16-bit output

       --packet-loss
	      Simulate n % random Opus packet loss

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

EXAMPLES

       Decode a file input.opus to output.wav
	      opusdec input.opus output.wav

       Play a file input.opus and force output at 48000 regardless of the original sampling rate
       (48kHz output may be faster, due to avoiding resampling and some sound hardware produces higher quality output when run at 48kHz)
	      opusdec --rate 48000 input.opus

       Re-encode a high bitrate Opus file to a lower rate
	      opusdec input.opus - | opusenc --bitrate 64 - output.opus

       Play an http stream http://icecast.somwhere.org:8000/stream.opus with the help of curl on a system with pulseaudio
       (press ctrl-c to quit)
	      curl http://icecast.somwhere.org:8000/stream.opus | padsp opusdec -

AUTHORS

       Jean-Marc Valin <jmvalin@jmvalin.ca>
       Gregory Maxwell <greg@xiph.org>

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 opusinfo(1) for somewhat better diagnostics.

SEE ALSO

       opusenc(1), opusinfo(1)

Xiph.Org Foundation						    2012-05-28								opusdec(1)