File size: 2,143 Bytes
9d7cbf2
 
9e29ba2
 
 
9d7cbf2
 
9e29ba2
 
10b408c
9d7cbf2
 
9e29ba2
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
---
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.