What is it

HiFi-ESP32 is a handy, low-cost media device that will upgrade your legacy audio system with internet streaming capabilities. It exposes line-level output that you can plug into active speakers, a stereo amplifier, or headphones. They use the legendary PCM5100 DAC with supreme audio quality.

Use cases

HiFi-ESP32 is a flexible, open-source audio platform designed to fit into both smart homes and custom audio projects.

• Smart Home Audio & TTS
  Integrates with Home Assistant and Music Assistant for high-quality audio playback and text-to-speech announcements. Perfect for notifications, voice alerts, and whole-home audio driven by your smart home automations.
• Multi-Room Audio with Snapclient
  Use HiFi-ESP32 as a Snapclient endpoint to create perfectly synchronized multi-room audio systems. Ideal for distributed music playback without proprietary lock-in.
• Standalone Player with Squeezelite-ESP32
  Run Squeezelite-ESP32 for a self-contained network audio player supporting Spotify Connect, AirPlay, and Logitech Media Server (LMS) — no external computer required.
• Educational Projects & Teaching Platforms
  A powerful tool for schools, universities, and technical education. HiFi-ESP32 can be used to teach embedded systems, digital audio, networking, and open-source software — ranging from simple audio playback labs to advanced DSP, streaming, and real-time systems projects.
• Research, Prototyping & Experimentation
  Well-suited for rapid prototyping of audio devices, proofs-of-concept, and research projects involving DSP, low-latency streaming, wireless audio, or human-machine interaction.
• A Foundation for Custom Products & DIY Builds
  With all firmware and tooling fully open source, HiFi-ESP32 is an ideal base for custom audio devices — whether you’re building a personal DIY project, a small production run, or a community-driven product.

Features

⚠️ HiFi boards require an external amplifier or active speakers; you can't connect passive speakers to it.

💡 Need to connect speakers as well? Check out Amped-ESP32 / Amped-ESP32-Plus

💡 Need only speakers output? Check out Loud-ESP32 / Loud-ESP32-Plus

💡 Need more powerful DSP? Check out Louder-ESP32 / Louder-ESP32-Plus

** Enabling EQ controls in software is a work in progress

💡 Looking for a more feature-packed version? Check out HiFi Esparagus

Onboard PSRAM

Audio streaming requires proper buffering to work; even with ESP32 500K of RAM it is a challenging task. For that reason, most of the projects will require WROVER modules that have onboard PSRAM chips. All ESP32 Audio boards have an 8MB PSRAM chip onboard, connected via a high-speed interface. Any code using PSRAM with just work out-of-the box.

Board Pinout

HiFi-ESP32

Ethernet

Optional peripheral

Software

• Home Assistant smart home audio and notifications. Start from the web-installer, as soon as you configure WiFi, the boards will be discovered by the ESPHome add-in automatically. Dedicated configs can be found in the documentation for simple and stable media-player, experimental sendspin protocol, and experimental snapclient component
• Squeezelite-ESP32 Spotify Connect, AirPlay, Bluetooth or Logitech Media Server. Flash directly from your browser using the web-installer. Configure WiFi using Hotspot (default password: squeezelite). Don't forget to exit Recovery mode when done.
• Snapclient multi-room audio streaming with snapserver. Flash directly from your browser using the web-installer, as soon as you configure the WiFi board will discover the snapserver automatically
• Snapclient (edge) - developer version. Developer's version of the snapclient, less stable and more feature-rich for those who cannot wait for new features to be released. Installed via web-installer, similar to standard snapclient
• Apple AirPlay 2 with multi-room sync. Use Platformio IDE to build and flash the AirPlay2 firmware. Pre-configured configurations and web-installer is a work in progress, but you can get it working by providing board configurations and building firmware yourself.
• Your own software. Use Arduino IDE or Platformio IDE and the provided software samples

Using with Home Assistant

Both HiFi-ESP32 versions were created specifically to be used with Home Assistant via ESPHome integration. For both boards, rich configs were pre-created with hardware configuration for common use cases. These include

• media_player component for simple and robust media playback and TTS announcements (with ducking effect)
• Sendspin media player – new experimental protocol for multi-room sync with media controls and more
• An experimental snapclient component that allows near-perfect multi-room sync and seamless integration with Music Assistant
• Another snapclient fork with an implemented 15-band software equalizer and a rich set of EQ presets
• Voice assist config for S3-based boards, allowing local voice-controlled assist and automation

Configurations are being actively maintained and upgraded, new experimental components added for you to test and enjoy

Flashing ESP32-S3

ESP32-S3 boards have two ways of firmware update: (1) similarly to classic ESP32, they can be flashed over built-in UART, or (2) uniquely for S3, over built-in USB host controller. Since it is firmware-controlled, it may be disabled if not used (or, more commonly, not available with factory default empty firmware). When come unflashed ESP32-S3 device comes into a boot loop, with a USB-CDC device appearing and disappearing every second, and requires a special flashing initialisation sequence to get flashed:

• Press the IO0 (FLASH) button and keep it pressed
• Press and release the RESET button. Release the FLASH button.
• ESP32-S3 will enter download mode, and the USB-CDC device will appear and stay available
• Run flashing routine as usual, either through web-serial or esp_tool
• This time, it is not possible to reboot the device over USB, so press RESET once more
• Device will boot normally into firmware, and if USB-CDC is enabled in the firmware, you will be able to flash it normally, download mode and reset sequence will work over USB.
• If you manage to flash firmware without USB-CDC support, you need to go through the above sequence once more

Hardware

Please visit the hardware section for board schematics and PCB designs. Note that PCBs are shared as multi-layer PDFs.

Image