Spaces:
Running
Running
Upload README.md with huggingface_hub
Browse files
README.md
CHANGED
|
@@ -1,10 +1,86 @@
|
|
| 1 |
---
|
| 2 |
-
title:
|
| 3 |
-
emoji:
|
| 4 |
-
colorFrom:
|
| 5 |
-
colorTo:
|
| 6 |
sdk: static
|
| 7 |
pinned: false
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 8 |
---
|
| 9 |
|
| 10 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
---
|
| 2 |
+
title: DJ Reactor
|
| 3 |
+
emoji: "🎵"
|
| 4 |
+
colorFrom: purple
|
| 5 |
+
colorTo: blue
|
| 6 |
sdk: static
|
| 7 |
pinned: false
|
| 8 |
+
license: mit
|
| 9 |
+
short_description: "Music visualizer - Reachy Mini dances to your beat!"
|
| 10 |
+
tags:
|
| 11 |
+
- reachy_mini
|
| 12 |
+
- reachy_mini_python_app
|
| 13 |
+
- robot
|
| 14 |
+
- music
|
| 15 |
+
- visualization
|
| 16 |
+
- dance
|
| 17 |
---
|
| 18 |
|
| 19 |
+
# DJ Reactor
|
| 20 |
+
|
| 21 |
+
A music visualizer for Reachy Mini that makes your robot dance to the beat!
|
| 22 |
+
|
| 23 |
+
## Features
|
| 24 |
+
|
| 25 |
+
- **Real-time Audio Analysis** - Analyzes bass, mid, and treble frequencies
|
| 26 |
+
- **Expressive Dancing** - Full body sway, head bob, and antenna movements
|
| 27 |
+
- **Beat Detection** - Extra punch on detected beats
|
| 28 |
+
- **Multiple Audio Sources** - Microphone, system audio loopback, or any input
|
| 29 |
+
|
| 30 |
+
## Installation
|
| 31 |
+
|
| 32 |
+
```bash
|
| 33 |
+
pip install git+https://huggingface.co/spaces/RyeCatcher/dj-reactor
|
| 34 |
+
```
|
| 35 |
+
|
| 36 |
+
## Usage
|
| 37 |
+
|
| 38 |
+
1. Start the Reachy Mini daemon:
|
| 39 |
+
```bash
|
| 40 |
+
reachy-mini-daemon # or --sim for simulation
|
| 41 |
+
```
|
| 42 |
+
|
| 43 |
+
2. Open the dashboard at http://localhost:8000
|
| 44 |
+
|
| 45 |
+
3. Find "DJ Reactor" in Applications and click Start
|
| 46 |
+
|
| 47 |
+
4. Select your audio input and start vibing!
|
| 48 |
+
|
| 49 |
+
## System Audio Setup (macOS)
|
| 50 |
+
|
| 51 |
+
To capture system audio (Spotify, YouTube, etc.):
|
| 52 |
+
|
| 53 |
+
1. Install [BlackHole](https://existential.audio/blackhole/) audio driver
|
| 54 |
+
2. Open Audio MIDI Setup
|
| 55 |
+
3. Create a Multi-Output Device with your speakers + BlackHole
|
| 56 |
+
4. Set as system output
|
| 57 |
+
5. Select "BlackHole 2ch" as input in DJ Reactor
|
| 58 |
+
|
| 59 |
+
## How It Works
|
| 60 |
+
|
| 61 |
+
DJ Reactor uses real-time FFT analysis to extract:
|
| 62 |
+
- **Bass (20-250 Hz)** → Body sway intensity
|
| 63 |
+
- **Mid (250-2000 Hz)** → Head movement
|
| 64 |
+
- **Treble (2000-12000 Hz)** → Antenna activity
|
| 65 |
+
- **Beat detection** → Extra head dip on beats
|
| 66 |
+
|
| 67 |
+
The robot's movements are synchronized to an internal groove cycle that adjusts with the detected BPM.
|
| 68 |
+
|
| 69 |
+
## Configuration
|
| 70 |
+
|
| 71 |
+
- **Intensity Slider** - Control how dramatic the movements are (0.1-1.0)
|
| 72 |
+
- **Audio Device** - Select microphone or loopback device
|
| 73 |
+
|
| 74 |
+
## Requirements
|
| 75 |
+
|
| 76 |
+
- Reachy Mini robot or simulator
|
| 77 |
+
- Python 3.10+
|
| 78 |
+
- Audio input device
|
| 79 |
+
|
| 80 |
+
## License
|
| 81 |
+
|
| 82 |
+
MIT License
|
| 83 |
+
|
| 84 |
+
## Credits
|
| 85 |
+
|
| 86 |
+
Built for the [Reachy Mini](https://github.com/pollen-robotics/reachy_mini) platform by Pollen Robotics.
|