zspot

A Spotify Connect player for devices running Zephyr RTOS, with the Spotify protocol packaged as a Zephyr module.

Now Playing, lyrics, a playlist from Your Library and the Wi-Fi password entry, on native_sim with demo data.

Features

• Shows up as a device in the Spotify app and plays through an I2S DAC.

• Now Playing screen with cover art, progress, seeking, transport, repeat and volume controls.

• Search, Your Library (Liked Songs and playlists) and synced lyrics on the device.

• Wi-Fi setup on the screen, including forgetting stored networks.

• Reconnects on its own when the network or the Spotify connection drops.

• Runs on the ESP32-S3 (VIEWE UEDX32480035E-WB-A) and on native_sim.

• The protocol library (lib/zspot) has a plain C API and can be used without the player.

A Spotify Premium account is required.

Contents

• Getting started
  • Requirements
  • Setting up a workspace
  • Repository layout
  • Building the documentation
• The player
  • ESP32-S3
  • Using it
  • Search and Your Library
  • native_sim
  • Checking the audio without a DAC
  • Application options
• Hardware
  • VIEWE UEDX32480035E-WB-A
  • I2S pins
  • MAX98357 amplifier
  • Other boards
• The library
  • Minimal example
  • API overview
  • Events
  • PCM callback
  • Configuration
• Architecture
  • Layers
  • Threads
  • Connection handling
  • Memory
  • Discovery and hand-over
• Troubleshooting
  • The device does not appear in the Spotify app
  • The device cannot join Wi-Fi
  • No sound
  • Playing a podcast fails from Your Library or search
  • native_sim aborts with terminate called
  • Reading a crash on native_sim
• Licence