8000
Skip to content

[audio] Bump microDecoder to v0.4.0 - #18291

Merged
bdraco merged 1 commit into
esphome:devfrom
kahrendt:micro-decoder-v0.4.0
Aug 11, 2026
Merged

[audio] Bump microDecoder to v0.4.0#18291
bdraco merged 1 commit into
esphome:devfrom
kahrendt:micro-decoder-v0.4.0

Conversation

@kahrendt
@kahrendt kahrendt commented Aug 11, 2026
Copy link
Copy Markdown
Contributor

What does this implement/fix?

Bumps the microDecoder library (GitHub/Espressif Registry) to v0.4.0 (changelog).

  • Fixes several bugs and makes other easier to diagnose
  • v0.4.0 includes Ogg Vorbis suport enabled by default, so until ESPHome supports it properly it is always disabled in the codegen stage
  • v0.3.0 added support for external https certificate bundles, so a future ESPHome PR could utilize that for custom certificates.

Types of changes

  • Bugfix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • New developer-facing feature (adds functionality for component developers; no end-user configuration change)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected) — policy
  • Developer breaking change (an API change that could break external components) — policy
  • Undocumented C++ API change (removal or change of undocumented public methods that lambda users may depend on) — policy
  • Code quality improvements to existing code or addition of tests
  • Other

Related issue or feature (if applicable):

Pull request in esphome.io with documentation (if applicable): not applicable

Pull request in developers.esphome.io with developer documentation (if applicable): not applicable

Test Environment

  • ESP32
  • ESP32 IDF
  • ESP8266
  • RP2040/RP2350
  • BK72xx
  • RTL87xx
  • LN882x
  • nRF52840

Example entry for config.yaml:

# Example config.yaml
media_player:
  - platform: speaker_source
    id: external_media_player
    name: Media Player
    announcement_pipeline:
      format: FLAC
      num_channels: 1
      sample_rate: 48000
      speaker: box_speaker
      sources:
        - http_announcement_source
    
media_source:
  - platform: audio_http
    id: http_announcement_source

Checklist:

  • The code change is tested and works locally.
  • Tests have been added to verify that the new code works (under tests/ folder).

If user exposed functionality or configuration variables are added/changed:

@kahrendt
[audio] Bump microDecoder to v0.4.0
775a036 
- Fixes several bugs and makes other easier to diagnose
- v0.4.0 includes Ogg Vorbis suport enabled by default, so until ESPHome supports it properly it is always disabled
Copilot AI lite review requested due to automatic review settings August 11, 2026 19:34
@esphome
esphome Bot commented Aug 11, 2026
Copy link
Copy Markdown
Contributor

To use the changes in this PR:

# Clone the repository:
git clone https://github.com/esphome/esphome
cd esphome

# Checkout the PR branch:
git fetch origin pull/18291/head:micro-decoder-v0.4.0
git checkout micro-decoder-v0.4.0

# Install the development version:
script/setup

# Activate the development version:
source venv/bin/activate

Now you can run esphome as usual to test the changes in this PR.

(Added by the PR bot)

@kahrendt kahrendt added this to the 2026.8.0 milestone Aug 11, 2026
@codecov
codecov Bot commented Aug 11, 2026 •
edited
Loading
Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 87.97%. Comparing base (55bd637) to head (775a036).
⚠️ Report is 2 commits behind head on dev.

Additional details and impacted files

Impacted file tree graph

@@           Coverage Diff           @@
##              dev   #18291   +/-   ##
=======================================
  Coverage   87.97%   87.97%           
=======================================
  Files          65       65           
  Lines       14890    14890           
  Branches     2239     2239           
=======================================
  Hits        13100    13100           
  Misses       1478     1478           
  Partials      312      312
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Copilot AI reviewed Aug 11, 2026
View reviewed changes
Copilot AI left a comment
Copy link
Copy Markdown
Contributor
< 8000 /a>

Choose a reason for hiding this comment

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

Pull request overview

This PR updates ESPHome’s ESP-IDF audio dependency set to use esphome/micro-decoder v0.4.0, aligning both the repository’s IDF component manifest and the audio component’s codegen to that version. It also proactively disables the newly-enabled Vorbis codec in micro-decoder because ESPHome does not support it yet.

Changes:

  • Bump esphome/micro-decoder dependency from 0.2.0 to 0.4.0 in the ESPHome IDF component manifest.
  • Update audio code generation to pull esphome/micro-decoder v0.4.0.
  • Always disable CONFIG_MICRO_DECODER_CODEC_VORBIS in IDF sdkconfig to prevent unsupported Vorbis decoding.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
esphome/idf_component.yml Updates the pinned ESP-IDF managed component version for esphome/micro-decoder to 0.4.0.
esphome/components/audio/init.py Updates codegen to use micro-decoder 0.4.0 and disables Vorbis via sdkconfig.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@github-actions
github-actions Bot commented Aug 11, 2026
Copy link
Copy Markdown
Contributor

Memory Impact Analysis

Components: audio
Platform: esp32-idf

Metric Target Branch This PR Change
RAM 21,964 bytes 21,964 bytes ➡️ +0 bytes (0.00%)
Flash 189,975 bytes 189,975 bytes ➡️ +0 bytes (0.00%)

Note: This analysis measures static RAM and Flash usage only (compile-time allocation).
Dynamic memory (heap) cannot be measured automatically.
⚠️ You must test this PR on a real device to measure free heap and ensure no runtime memory issues.

This analysis runs automatically when components change. Memory usage is measured from a representative test configuration.

@bdraco
bdraco merged commit 4a7de87 into esphome:dev Aug 11, 2026
68 of 69 checks passed
@jesserockz jesserockz removed this from the 2026.8.0 milestone Aug 12, 2026
@github-actions github-actions Bot locked and limited conversation to collaborators Aug 13, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Reviewers

Copilot code review Copilot
Copilot review effort
Applies to this pull request for everyone.Learn more about Copilot code review.
Copilot left review comments
@bdraco bdraco bdraco approved these changes

Assignees

No one assigned

Labels

bugfix by-code-owner component: audio core small-pr PR < 30 lines

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

micro_decoder: LoadStoreError crash on ESP32 M5Stack Atom echo (no PSRAM) playing HTTP media

4 participants

@kahrendt @bdraco @jesserockz
0