README.md

Espressif Audio Development Framework

Espressif Systems Audio Development Framework (ESP-ADF) is the official audio development framework for the ESP32 chip.

Overview

ESP-ADF supports development of audio applications for the Espressif Systems ESP32 chip in the most comprehensive way. With ESP-ADF, you can easily add features, develop audio applications from simple to complex:

• Music player or recorder supports audio formats such as MP3, AAC, WAV, OGG, AMR, SPEEX ...
• Play music from sources: HTTP, SDCARD, Bluetooth A2DP/HFP
• Intergrate Media services such as: DLNA, Wechat ..
• Internet Radio
• Voice recognition and integration with online services such as Alexa, DuerOS, ...

As a general, the ESP-ADF features will be supported as shown below:

Developing with the ESP-ADF

Hardware

Espressif Systems has released a number of support boards for ESP-ADF to develop ESP32 audio applications, including:

ESP32-Lyrat

ESP32 LyraT V4 Getting Started Guide

ESP-IDF

ESP-ADF is based on the application layer of ESP-IDF ([Espressif IoT Development Framework] (https://github.com/espressif/esp-idf)). So you need to first install the ESP-IDF and then use the ESP-ADF. Please take a look at Get Started

Examples

Check folder examples that contains sample applications to demonstrate API features of the ESP-ADF.

Resources

• Documentation for the latest version: https://esp-adf.readthedocs.io/. This documentation is built from the docs directory of this repository.

• The esp32.com forum is a place to ask questions and find community resources.

• Check the Issues section on github if you find a bug or have a feature request. Please check existing Issues before opening a new one.

• If you're interested in contributing to ESP-ADF, please check the Contributions Guide.