Opus Bandwidth
Understand Opus codec bandwidth measurement — how CallMeter tracks the frequency bandwidth of Opus audio streams, thresholds, and what bandwidth changes reveal about audio richness.
Opus Bandwidth reports the frequency range that the Opus codec is currently encoding, measured in kHz. Opus dynamically selects from five bandwidth modes depending on the audio content, network conditions, and encoder configuration. Higher bandwidth means richer, more natural-sounding audio.
Think of it like the difference between a phone call and an FM radio broadcast. A narrowband call (4 kHz) sounds like a traditional telephone. A fullband stream (20 kHz) sounds like the person is in the room with you.
Opus only
This metric applies exclusively to Opus-encoded audio streams. Other codecs like G.711 or G.722 have fixed bandwidth and do not report this value.
How It Works
Opus supports five bandwidth modes:
| Mode | Frequency | kHz Value | Sound Quality |
|---|---|---|---|
| Narrowband | 0 - 4 kHz | 4 | Traditional telephone quality |
| Mediumband | 0 - 6 kHz | 6 | Improved clarity over narrowband |
| Wideband | 0 - 8 kHz | 8 | HD Voice quality |
| Super-wideband | 0 - 12 kHz | 12 | Near-broadcast quality |
| Fullband | 0 - 20 kHz | 20 | Full audio spectrum, studio quality |
The Opus encoder dynamically selects the bandwidth based on available bitrate, audio content, and configuration constraints. CallMeter reports the current bandwidth selection each second, allowing you to track how the codec adapts over the duration of a call.
Why It Matters
Opus bandwidth directly determines perceived audio richness. Higher bandwidth captures more of the speaker's voice characteristics, environmental sounds, and tonal nuances. For enterprise communications, wideband or better audio is the standard expectation.
Bandwidth drops during a call are significant — they indicate the encoder is under pressure (usually from reduced available bitrate) and is sacrificing audio richness to maintain the connection.
Thresholds
| Level | Bandwidth | Interpretation |
|---|---|---|
| Good | 12 kHz or higher | Super-wideband or fullband, excellent audio richness |
| Warning | 8 kHz | Wideband; acceptable but reduced compared to modern expectations |
| Critical | Below 6 kHz | Narrowband territory, noticeable quality reduction |
Common Causes of Low Opus Bandwidth
| Cause | Explanation |
|---|---|
| Low bitrate allocation | Encoder given insufficient bitrate to sustain high bandwidth |
| Network congestion | Bitrate reduced by congestion control, forcing bandwidth down |
| Encoder configuration | Maximum bandwidth explicitly limited in codec settings |
| SDP negotiation constraints | Remote endpoint requesting narrower bandwidth in the offer/answer |
| Transcoding through SBC | Session Border Controller re-encoding at lower quality settings |
How to Fix It
- Check bitrate allocation — Opus needs approximately 16 kbps for wideband, 24 kbps for super-wideband, and 32+ kbps for fullband. Ensure the encoder has enough bitrate.
- Monitor bitrate over time — If bandwidth drops mid-call, check whether Send Bitrate drops at the same time, indicating congestion-driven adaptation.
- Review codec negotiation — Check SDP parameters for
maxplaybackrateor bandwidth constraints that may limit the encoder. - Test without intermediaries — If an SBC or transcoder sits in the path, test directly between endpoints to determine whether the intermediary is downgrading the audio.
- Verify Opus configuration — Ensure the encoder's bandwidth setting is not artificially restricted to narrowband or mediumband.
Related Metrics
- Audio Signal Level — Higher bandwidth captures more speech detail at any volume level
- Opus Packet Loss % — Loss can trigger bandwidth reduction as the encoder adapts
- MOS Score — Overall quality score influenced by codec bandwidth
- Send Bitrate — Available bitrate directly constrains Opus bandwidth selection
RFC Reference
Opus bandwidth modes are defined in RFC 6716 (Definition of the Opus Audio Codec), Section 2. The five bandwidth levels correspond to internal modes of the SILK and CELT layers within the codec. Recommended configurations for VoIP usage are detailed in RFC 7587 (RTP Payload Format for the Opus Speech and Audio Codec).
Comfort Noise Rate
Understand Comfort Noise insertion measurement in VoIP calls — how CallMeter tracks CNG events during silence, and what the presence or absence of comfort noise means for call quality.
Opus Decoder Gain
Understand Opus decoder gain measurement — how CallMeter tracks volume adjustments applied by the Opus decoder, and what non-zero gain values reveal about audio level issues.