opusdec(1)

✨ opusdec 💖

okay bestie, sit DOWN, because we're about to talk about opusdec(1) from opus-tools and honestly? she's iconic. this is the girl who takes your Opus audio and turns it into Wave or raw PCM. that's the whole job. no cap. 🎀

---

🌸 NAME 🌸

opusdec — decode audio in Opus format to Wave or raw PCM 🦋

---

🫶 SYNOPSIS 🫶

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

like, that's the whole vibe check right there. look at her go. ✨

---

💅 DESCRIPTION 💅

opusdec decodes Opus URLs or files to uncompressed Wave or raw PCM. that's the main character mission statement fr fr.

In URLs, the file, http, and https schemes are supported — unless HTTP support was disabled at build time, in which case, sorry bestie, that door is closed. 🙈

If the input file is specified as -, then opusdec will read from stdin. Likewise, an output filename of - will cause output to be to stdout. yes queen, the classic dash pipeline situation. so versatile, so flexible, obsessed. 💖

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

---

👑 OPTIONS 👑

• -h, --help — Show help message. ask and she shall answer 💜
• -V, --version — Show version information. the receipts, the credentials, the lore ⭐
• --quiet — Suppresses program output. shhh. silence. a moment of peace 🧚
• --rate n — Force decoding at sampling rate n Hz. you pick the number, she respects it 💅
• --force-stereo — Force decoding to stereo. both ears get the tea 🎧
• --gain n — Adjust the output volume n dB, negative values make the signal quieter. yes, negative = quieter, read it again bestie 😭
• --no-dither — Do not dither 16-bit output. no dithering. none. zero. zilch 🌸
• --float — Output 32-bit floating-point samples instead of 16-bit integer samples. glow-up for your samples ✨
• --force-wav — Force including a Wave header on output (e.g. for non-wav extensions and stdout). sometimes you just gotta label the vibes 🏷️
• --packet-loss n — Simulate n % random Opus packet loss. chaos simulator, but make it science 💀
• --save-range file — Save check values for every frame to a file. for the record-keepers 🍓

---

🌈 EXAMPLES 🌈

these are copy-paste-able, do NOT come for me if you retype them wrong

Decode a file input.opus to output.wav

opusdec input.opus output.wav

Play a file input.opus

opusdec input.opus

Re-encode a high bitrate Opus file to a lower rate

opusdec --force-wav input.opus - | opusenc --bitrate 64 - output.opus

Play an http stream http://icecast.somwhere.org:8000/stream.opus on a system with pulseaudio (press ctrl-c to quit)

padsp opusdec http://icecast.somwhere.org:8000/stream.opus

that pipe example in the middle? she's giving pipeline royalty. 👑

---

💜 AUTHORS 💜

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

the founders. the architects. the ones who did it first. 🫶

---

😭 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.

okay so she's a little too trusting, she lets some sketchy files through, and when she does catch a bad one she's kinda vague about it. not a red flag, just a yellow one. use opusinfo(1) if you need the actual detective work. 🔍

---

⭐ SEE ALSO ⭐

• opusenc(1)
• opusinfo(1)

---

and that's the whole page bestie, thanks for coming to my ted talk 💖

Xiph.Org Foundation · 2012-08-31 · from the opus-tools era, and she still ate. mwah. 💅✨🦋