跳转到内容

Squeezelite-ESP32 ​

Squeezelite-ESP32 是经典开源播放器 Squeezelite 在 ESP32 上的移植:一块 ESP32 加一个 I2S DAC,就能变成能同步播放的网络音频播放器。它主要面向 Logitech Media Server (LMS) 用户,也支持 AirPlay、蓝牙接收和 Spotify Connect,适合做多房间音乐系统。

项目概况 ​

项目内容
仓库github.com/sle118/squeezelite-esp32
作者 / 组织sle118,Squeezelite 移植由 philippe44 完成
开源协议仓库根目录未见 LICENSE 文件,GitHub 也未识别协议,使用前请自行核对子组件的授权
支持芯片README 写明 ESP32 与 ESP32-S3
首次发布仓库创建于 2019 年 5 月 21 日
热度约 2200 星(2026 年 10 月)

它是怎么工作的 ​

README 的开头特意提醒:越来越多的人不用 LMS 服务器,只用它做蓝牙、AirPlay 或 Spotify。可以,但它的设计核心依然是 LMS 播放器。

支持的音源:

  • LMS:本地音乐库和主流在线音乐服务,通过 LMS 实现多房间同步。
  • 蓝牙:手机直接把音频推送给 ESP32。
  • AirPlay:仅 AirPlay 1,同样可多房间同步。
  • Spotify Connect:基于 cspot,README 要求仔细阅读相关说明。

输出:I2S DAC、S/PDIF,或者通过蓝牙发送到蓝牙喇叭。

性能方面,README 给出了两种内部精度:16 位核心最高支持 192 kHz,但很吃 CPU;32 位模式最高 96 kHz。解码、均衡器、重采样、淡入淡出的能力都有表格说明。

需要的硬件 ​

部件说明
最低要求WROVER 模块,4MB Flash + 4MB PSRAM(README 要求)
音频输出I2S DAC(PCM5102、TAS5713 等常见芯片)、S/PDIF 或蓝牙
可选按键、旋转编码器、红外接收、OLED / LCD 屏幕(SSD1306、ST7789、ILI9341 等)、LED 灯带做 VU 表、有线以太网
现成板社区有 Muse 系列等专用音频板,请以仓库和论坛为准

音频输出板的选择可参考 音频玩法。

上手路径 ​

  1. 准备 ESP32-WROVER 或 S3 开发板和一块 I2S DAC。
  2. 在仓库 release 里找对应固件,用 esptool 或 Web 烧录(参见 烧录工具)。
  3. 设备启动后用 Wi-Fi 热点进入网页配置,设置 DAC 的 GPIO。
  4. 在 LMS 里看到新播放器,开始播放;或用手机直接 AirPlay / 蓝牙连接。
  5. 想要显示屏幕上的歌曲信息,需要在 LMS 安装作者提供的插件。

生态与衍生 ​

  • 上游:Squeezelite、cspot 等开源项目。
  • Home Assistant:LMS 与 Squeezebox 有对应集成。
  • 对比:ESPHome 也能做媒体播放器,但没有 LMS 的同步能力;Home Assistant Voice PE 偏向语音助手。

局限与注意事项 ​

  • 配置门槛较高,硬件接线要对着文档来。
  • ESP32 资源紧张,高采样率与屏幕同时使用时会吃力。
  • AirPlay 仅 1,不支持 AirPlay 2。
  • 许可证不明确,商用需谨慎核对。
  • Spotify 功能依赖第三方库 cspot,有账号限制,请读 README 的说明。

参考资料 ​

ESP32 非官方中文调查手册,与乐鑫科技(Espressif Systems)无隶属关系。