| --- |
| 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](https://huggingface.co/spaces/RyeCatcher/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 |
|
|
| ```bash |
| pip install spotify_dancer |
| ``` |
|
|
| ## Setup |
|
|
| ### 1. Install Spotify Connect (raspotify) |
|
|
| ```bash |
| 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: |
|
|
| ```bash |
| sudo modprobe snd-aloop pcm_substreams=1 |
| echo 'snd-aloop' | sudo tee /etc/modules-load.d/loopback.conf |
| ``` |
|
|
| See the [full ALSA setup guide](docs/spotify_setup.md) for multi-output configuration. |
|
|
| ### 3. Fix Service Permissions |
|
|
| Create `/etc/systemd/system/raspotify.service.d/override.conf`: |
|
|
| ```ini |
| [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](docs/spotify_setup.md) |
| |
| ## License |
| |
| MIT License |
| |
| ## Credits |
| |
| - **DJ Reactor** by [RyeCatcher](https://huggingface.co/spaces/RyeCatcher/dj_reactor) - Original dance movement system |
| - **Spotify Connect** via [raspotify](https://github.com/dtcooper/raspotify) (librespot wrapper) |
| - Built for the Reachy Mini community |
| |
