README.md

metadata

title: Spotify Dancer
emoji: 🎵
colorFrom: green
colorTo: gray
sdk: static
pinned: false
license: mit
short_description: Reachy Mini dances to your Spotify music!
tags:
  - reachy_mini
  - reachy_mini_python_app
  - robot
  - spotify
  - dance
  - music

Spotify Dancer for Reachy Mini

Make your Reachy Mini dance to Spotify music! This app analyzes audio in real-time and generates expressive robot movements synchronized to the beat.

Based on DJ Reactor by RyeCatcher, enhanced with Spotify Connect integration and ALSA loopback for best audio detection quality.

Features

• Spotify Connect - Reachy Mini appears as a speaker in your Spotify app
• Real-time Beat Detection - BPM estimation and beat tracking
• Dance Styles - Energetic, Groovy, Chill, and Hip-Hop modes
• Stream Analysis - Direct audio capture via ALSA loopback (best quality)
• Web Control Panel - Live visualizer with adjustable settings
• Auto-Configuration - Automatically detects and fixes ALSA audio settings

Requirements

• Reachy Mini WiFi version (wireless connectivity required for Spotify Connect)
• Python 3.10+
• Spotify account (Free or Premium)

Installation

From Reachy Mini Dashboard

1. Go to http://reachy-mini.local:8000
2. Navigate to Apps
3. Search for "Spotify Dancer"
4. Click Install

Manual Installation

pip install spotify_dancer

Setup

1. Install Spotify Connect (raspotify)

curl -sL https://dtcooper.github.io/raspotify/install.sh | sh

# Configure
sudo nano /etc/raspotify/conf
# Set: LIBRESPOT_NAME="Reachy Mini"
# Set: LIBRESPOT_DEVICE=spotify

2. Enable ALSA Loopback (Recommended)

For best audio detection, use ALSA loopback:

sudo modprobe snd-aloop pcm_substreams=1
echo 'snd-aloop' | sudo tee /etc/modules-load.d/loopback.conf

See the full ALSA setup guide for multi-output configuration.

3. Fix Service Permissions

Create /etc/systemd/system/raspotify.service.d/override.conf:

[Service]
PrivateUsers=false
PrivateTmp=false
ProtectSystem=false
RemoveIPC=false
User=pollen
Group=audio

Then: sudo systemctl daemon-reload && sudo systemctl restart raspotify

Usage

1. Start the app from Reachy Mini dashboard
2. Open control panel: http://reachy-mini.local:7860
3. Select loopback_in as Audio Input
4. Choose a dance style
5. Click Start Dancing
6. Play music on Spotify → Select "Reachy Mini" as speaker

Dance Styles

Style	Best For	Movement
Energetic	Rock, EDM	Strong head bobs, wide sway
Groovy	Pop, Funk	Classic nods, balanced movement
Chill	Jazz, Lo-Fi	Smooth tilts, gentle sway
Hip-Hop	Rap, R&B	Rhythmic nods, bass-driven

Audio Input Options

Device	Quality	Notes
loopback_in	⭐ Best	Direct stream capture
reachymini_audio_src	Poor	Microphone with echo cancellation issues

Architecture

Spotify App → raspotify → ALSA multi-output
                              ├──→ Speaker
                              └──→ Loopback → Spotify Dancer → Robot

Troubleshooting

• No loopback_in device: Run sudo modprobe snd-aloop and restart the app
• Poor detection: Use loopback_in, increase sensitivity, turn up volume
• Tracks skip: Check ALSA config and IPC permissions (see setup guide)
• ALSA errors after reboot: The app auto-detects and fixes card numbers on startup. If issues persist, see the setup guide

License

MIT License

Credits

• DJ Reactor by RyeCatcher - Original dance movement system
• Spotify Connect via raspotify (librespot wrapper)
• Built for the Reachy Mini community