Skip to content

Add .opus audio to various docs#11940

Open
Joy-less wants to merge 4 commits intogodotengine:masterfrom
Joy-less:add-opus-to-docs
Open

Add .opus audio to various docs#11940
Joy-less wants to merge 4 commits intogodotengine:masterfrom
Joy-less:add-opus-to-docs

Conversation

@Joy-less
Copy link
Copy Markdown
Contributor

@Joy-less Joy-less commented Apr 21, 2026

This pull request is based on the changes in godotengine/godot#117921 (Add support for .opus audio files).

Summary of changes:

  • Adds Opus as an option when referring to WAV, MP3 and OGG Vorbis.
  • Adds a recommendation to use Opus to reduce file size while maintaining quality.
  • Adds a section including a comparison for the transparent bitrate for each format.
    • MP3 and Ogg Vorbis transparency bitrates are based on the Hydrogenaudio Knowledgebase.

      MP3-encoded files are generally considered artifact-free at bitrates at/above 192kbps.
      Vorbis ogg files are supposedly artifact-free at bitrates at/above 160kbps.

    • Opus transparency bitrate is based on the Audacity manual.

      Opus at 128 kbps VBR (default settings) is pretty much transparent.

    • WAV transparency bitrate is based on standard CD-quality (44.1kHz, 16-bit, stereo).

@Joy-less Joy-less requested review from a team as code owners April 21, 2026 01:00
@aaronfranke aaronfranke changed the title Add Opus to various docs Add .opus audio to various docs Apr 21, 2026
Comment thread tutorials/io/runtime_file_loading_and_saving.rst Outdated
Comment thread tutorials/assets_pipeline/importing_audio_samples.rst Outdated
Comment thread tutorials/assets_pipeline/importing_audio_samples.rst Outdated
Comment thread tutorials/assets_pipeline/importing_audio_samples.rst Outdated
Comment thread tutorials/assets_pipeline/importing_audio_samples.rst Outdated
Comment thread tutorials/assets_pipeline/importing_audio_samples.rst Outdated
Comment thread tutorials/assets_pipeline/importing_audio_samples.rst Outdated
Comment thread tutorials/assets_pipeline/importing_audio_samples.rst Outdated
Comment thread tutorials/assets_pipeline/importing_audio_samples.rst Outdated
Comment thread tutorials/assets_pipeline/importing_audio_samples.rst Outdated
@AThousandShips AThousandShips added enhancement area:manual Issues and PRs related to the Manual/Tutorials section of the documentation waiting on pr merge PRs that can't be merged until an engine PR is merged first labels Apr 21, 2026
Joy-less and others added 2 commits April 21, 2026 14:50
Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com>
Comment thread tutorials/assets_pipeline/importing_audio_samples.rst Outdated
Co-authored-by: Hugo Locurcio <hugo.locurcio@hugo.pro>
Copy link
Copy Markdown
Member

@Calinou Calinou left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me.

I'm a bit surprised that the estimated transparency bitrate for Opus is 128 Kb/s, as I often read it was around 96 Kb/s in other places. I guess we can trust Hydrogenaudio's advice on this still.

@Joy-less
Copy link
Copy Markdown
Contributor Author

Joy-less commented Apr 22, 2026

I'm a bit surprised that the estimated transparency bitrate for Opus is 128 Kb/s, as I often read it was around 96 Kb/s in other places. I guess we can trust Hydrogenaudio's advice on this still.

Indeed. Opus recommends 64-96kbps for music streaming, but 96-128kbps for music storage.
According to https://listening-test.coresv.net/results.htm, volunteers rated 96kbps Opus inbetween "Imperceptible" and "Perceptible, but not annoying" for every track.
Probably fine for a game, but not transparent until 128kbps.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:manual Issues and PRs related to the Manual/Tutorials section of the documentation enhancement waiting on pr merge PRs that can't be merged until an engine PR is merged first

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants