---
title: Spotify Manager
emoji: 🎵
colorFrom: green
colorTo: gray
sdk: static
pinned: false
tags:
  - reachy_mini
  - reachy_mini_python_app
---

# Spotify Manager

🎵 Your robot DJ — control Spotify with hand gestures, voice commands, and full robot personality feedback.

## Features

- **🖐️ Gesture Control** — Wave to skip, thumbs up to like, open palm to play/pause, point to navigate, fist for volume down
- **🎤 Voice Commands** — "Pon Arctic Monkeys", "siguiente", "pause", "sube volumen" (Spanish + English)
- **🤖 Robot Feedback** — Head flicks, antenna spreads, nods, and tilts react to every action
- **🔄 Now Playing Detection** — Robot notices track changes with a curious tilt

## Gestures

| Gesture | Action |
|---------|--------|
| 🖐️ Open Palm | Play / Pause toggle |
| 👆 Point Right | Next track |
| 👈 Point Left | Previous track |
| 👍 Thumbs Up | Like current track |
| ✊ Fist | Volume down |
| 👋 Wave | Skip track |

## Requirements

- [spogo](https://github.com/nicholasgasior/spogo) CLI installed and authenticated
- Camera for gesture detection
- Microphone for voice commands (optional)

## Install

```bash
cd spotify_manager
pip install -e .
```

## Test locally

```bash
# Check spogo works
spogo status --json

# Run the app in simulator
python -m spotify_manager.demo
```

## Voice Commands (ES/EN)

- "siguiente" / "next" / "skip"
- "anterior" / "prev"
- "pausa" / "pause"
- "play" / "reproduce" / "dale"
- "sube volumen" / "baja volumen"
- "me gusta" / "like"
- "pon [artista/canción]" / "play [query]"
- "qué suena" / "what's playing"

## Architecture

```
spotify_manager/
├── main.py              # ReachyMiniApp entry point
├── spotify_control.py   # spogo CLI wrapper
├── gesture_controller.py # MediaPipe hand gesture → command
├── voice_controller.py  # Whisper STT → intent parser
├── robot_feedback.py    # Physical robot reactions
└── demo.py              # MuJoCo simulator demo + video recording
```

## HuggingFace Space

Will be deployed to `jrubiosainz/spotify_manager` once spogo integration is validated.