How do I set up buttons and rotary encoders on squeezelite-esp32?

Configure buttons using JSON syntax in the NVS parameters, as detailed in the 'Buttons' section of the README. You'll need to map GPIO pins to actions like play or volume, and consider debounce and long-press options for advanced control.

Squeezelite-esp32 vs ESP32-A2DP for Bluetooth audio?

Squeezelite-esp32 offers multi-protocol support including LMS and AirPlay, while ESP32-A2DP is focused solely on Bluetooth. Choose squeezelite-esp32 if you need broader streaming options, but note its Bluetooth mode is an add-on with potential limitations.

Can squeezelite-esp32 play 24-bit/192kHz FLAC files?

In 16-bit mode, it supports up to 192kHz but recommends limiting to 96kHz for stability. 24-bit files are truncated in 16-bit mode, and high rates may cause stuttering due to CPU and memory constraints, as explained in the performances table.

How to enable Spotify Connect on squeezelite-esp32 without LMS?

Use the cspot integration via the web UI or NVS parameters, but be aware it's an add-on mode with ZeroConf options that might affect registration and stability, as noted in the Spotify configuration section.

What displays are compatible with squeezelite-esp32?

Supports monochrome, grayscale, and color displays using SPI or I2C, including drivers like SH1106, SSD1306, ST7789, and ILI9341, with configurable options for orientation and artwork as listed in the 'Display' section.

Open-Awesome

Squeezelite-esp32

CSqueezeAmp.32.1769.master-v4.3

ESP32-based audio streaming software supporting multi-room sync, AirPlay, Bluetooth, and LMS integration.

GitHub

2.2k stars231 forks0 contributors

What is Squeezelite-esp32?

Squeezelite-esp32 is an open-source audio streaming software for ESP32 microcontrollers that turns them into networked audio players. It supports streaming from Logitech Media Server, AirPlay, Bluetooth, and Spotify Connect, with features like multi-room synchronization and hardware extensibility. The project solves the need for a customizable, low-cost audio streaming solution that can be integrated into DIY or commercial audio hardware.

Target Audience

DIY audio enthusiasts, hardware developers, and makers building custom streaming audio devices or multi-room audio systems using ESP32-based hardware. It's also suitable for those seeking an open-source alternative to proprietary streaming receivers.

Value Proposition

Developers choose Squeezelite-esp32 for its extensive protocol support, hardware flexibility, and active community. Unlike commercial alternatives, it offers full control over the audio pipeline, supports a wide range of peripherals, and can be tailored to specific project needs without licensing fees.

Overview

ESP32 Music streaming based on Squeezelite, with support for multi-room sync, AirPlay, Bluetooth, Hardware buttons, display and more

Use Cases

Best For

Building DIY networked audio players with ESP32
Creating multi-room synchronized audio systems
Adding AirPlay or Bluetooth streaming to existing audio hardware
Developing custom audio devices with displays and physical controls
Integrating Spotify Connect into open-source audio projects
Prototyping audio products with I2S DACs and SPDIF output

Not Ideal For

Projects focused solely on AirPlay 2 or Bluetooth 5.x streaming without Logitech Media Server integration
Applications demanding lossless high-resolution audio playback above 24-bit/96kHz without performance compromises
Teams seeking a pre-configured, out-of-the-box solution with minimal hardware tinkering and setup

Pros & Cons

Pros

Multi-Protocol Streaming

Supports Logitech Media Server, AirPlay, Bluetooth, and Spotify Connect, enabling flexible audio source integration as highlighted in the key features.

Extensive Hardware Support

Compatible with I2S DACs, SPDIF, displays, buttons, rotary encoders, and LED strips, allowing for highly customizable audio devices per the hardware extensibility section.

Web-Based Configuration

Offers a full web interface for setup, management, and over-the-air firmware updates, simplifying remote administration as described in the software configuration.

Active DIY Community

Backed by a large forum and detailed documentation, making it easier to troubleshoot and customize for specific projects, with examples like SqueezeAMP and Muse builds.

Cons

LMS-Centric Design

Non-LMS modes like AirPlay and Spotify Connect are described as 'add-ons stitched to it' with shortcomings in the forewords, limiting their reliability and feature parity.

Performance Limitations

CPU constraints on the ESP32 restrict high-resolution audio playback and can cause stuttering, especially with displays or complex processing, as noted in the performances section.

Complex Configuration

Requires manual setup of NVS parameters, JSON for buttons, and GPIO mappings, which can be error-prone and daunting for newcomers without deep hardware knowledge.

Frequently Asked Questions

Related Projects

ESP32-Radio

Internet radio based on ESP32, VS1053 and a TFT screen.

Stars1,074

Forks233

Last commit1 year ago

PedalinoMini

Wireless and Bluetooth MIDI/HID Foot Controller

Stars621

Forks98

Last commit5 months ago

ESPuino

RFID-controlled musicplayer powered by ESP32

A many speaker distributed music synthesizer using UDP multicast over WiFi

Stars323

Forks16