# schreibfaul1/ESP32-audioI2S

Play mp3 files from SD via I2S

Repository: https://github.com/schreibfaul1/ESP32-audioI2S
Canonical: https://ross.abutalabs.com/products/esp32-audioi2s
Language: C
License: GPL-3.0
License Family: copyleft
Topics: esp32, max98357a, i2s, mp3, pcm5102a, aac, google-tts, webradio, opus, flac, cs4344, m4a, vorbis
Last push: 2026-08-26T15:34:15+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 96, longevity 100
- inputs: {"age_days": 2866, "days_push": 7, "days_rel": 27, "gap_med": 30, "n_releases_24m": 14}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1682, forks 422 (observed 2026-08-28T04:05:21.615479+00:00)

## What it is
An Arduino/ESP32 library that plays audio files and streams (MP3, AAC, FLAC, WAV, Opus, Vorbis) through external I2S DACs like the MAX98357A or PCM5102A. It supports sources such as SD cards, HTTP web radio streams, m3u8 playlists, Google TTS, and OpenAI speech.

## Use cases
- play mp3 files from an SD card on ESP32
- build an ESP32 internet radio with web streams
- stream audio to a MAX98357A I2S amplifier
- play FLAC and Opus files on ESP32-S3
- add Google TTS speech playback to an ESP32 project
- decode m3u8 HLS audio streams on embedded hardware

## When to choose
- you need audio playback on ESP32, ESP32-S3, or ESP32-P4 with an external I2S DAC
- you want to stream web radio or play multiple audio codecs from SD card in Arduino
- you need a lightweight C++ audio decoder without an RTOS audio stack

## When to avoid
- you are using ESP32-S2, ESP32-C3, or other single-core chips that are unsupported
- you need audio output via the built-in DAC or Bluetooth audio input
- your project is not on the Arduino/ESP32 platform

## Facets
- artifact type: library
- maturity: active
- function: audio-processing, parser, http-client
- domain: embedded-systems, iot
- platform: embedded, iot, cpp
- tags: esp32, i2s, mp3, flac, opus, aac, web-radio, arduino, max98357a, pcm5102a, audio-streaming, google-tts, audio

## Member repositories
- schreibfaul1/ESP32-audioI2S (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:21.615479+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:41:23.332133+00:00, confidence not recorded.
  - readme: https://github.com/schreibfaul1/ESP32-audioI2S (fetched 2026-08-28T04:05:21.615479+00:00, sha f69a3bc328d3)
- Data as of 2026-08-30T08:39:29.467469+00:00.