|
|
--- |
|
|
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 |
|
|
|
