Opus Decode Errors

[atmaranto]

Summary

Occasionally, Opus decode errors will prevent getting sane audio data from stream

Reproduction Steps

This bug occurs inconsistently. Simply connecting to a voice channel and trying to receive data with start_recording is enough to cause it to occur, but sometimes, I'll start a voice channel with no issue. My assumption is there is some underlying internal inconsistency in what format Discord is using, and when it chooses a particular format, it fails. This is occurring with master and the most recent release candidate.

Minimal Reproducible Code

Expected Results

Like in previous versions, the audio to record without error.

Actual Results

Note: this error only appeared after I manually added a traceback.print_exc line in opus.py:

Traceback (most recent call last):
  File "/home/user/miniconda3/lib/python3.13/site-packages/discord/opus.py", line 549, in run
    data.decoded_data = self.get_decoder(data.ssrc).decode(
                        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^
        data.decrypted_data
        ^^^^^^^^^^^^^^^^^^^
    )
    ^
  File "/home/user/miniconda3/lib/python3.13/site-packages/discord/opus.py", line 514, in decode
    ret = _lib.opus_decode(
        self._state, data, len(data) if data else 0, pcm_ptr, frame_size, fec
    )
  File "/home/user/miniconda3/lib/python3.13/site-packages/discord/opus.py", line 131, in _err_lt
    raise OpusError(result)
discord.opus.OpusError: corrupted stream

Intents

intents = discord.Intents.default(); intents.members = True

System Information

• Python v3.13.2-final
• py-cord v2.7.None-candidate
  • py-cord importlib.metadata: v2.7.0rc1
• aiohttp v3.12.6
• system info: Linux 6.12.41+deb13-amd64 Update README.rst #1 SMP PREEMPT_DYNAMIC Debian 6.12.41-1 (2025-08-12)

Checklist

• I have searched the open issues for duplicates.
• I have shown the entire traceback, if possible.
• I have removed my token from display, if visible.

Additional Context

No response

[atmaranto]

@Lulalaby, would you recommend testing #2873 to see if it fixes this for me?

[Lulalaby]

I do not recommend using that pr yet

[Chalarca]

I have this same problem.

Mi code work propertli in 2.6.1 but when i update to the latest version to solve "unclosed connection" problem, this happend with my record commands.

In my case the problem always occur.

i dont know if is usefull but
When i print voice_client.mode return this aead_xchacha20_poly1305_rtpsize

This are my logs, i changed the try exept to have the exact error.

System Information
Python v3.11.0
py-cord importlib.metadata: v2.7.0rc1

[DA-344]

We are aware of the issue, and I am personally working on fixing it.