# HypeRate Music Matcher

> HypeRate Music Matcher is a free web application that connects real-time heart rate data to Apple Music or Spotify. It automatically switches playlists based on BPM — no manual interaction needed during workouts or live streams.

## What it does

- Reads live heart rate data from [HypeRate](https://hyperate.io) (supports smartwatches, chest straps, and BLE devices)
- Lets users assign Apple Music or Spotify playlists to up to 6 configurable heart rate ranges (e.g. 60–100 BPM → Chill, 100–150 BPM → EDM, 150+ BPM → Hardcore)
- Automatically switches to the correct playlist when BPM crosses a range boundary
- Supports crossfade transitions between playlists (400 ms – 3 000 ms)
- Provides an [OBS browser-source overlay](https://musicmatcher.hyperate.io/obs-overlay.html) showing current track, album art, and heart rate
- Integrates with Elgato Stream Deck via REST API endpoints for manual playback control
- Completely free — no subscription, no login required (beyond Apple Music / Spotify authorization)

## Target users

- Fitness streamers on Twitch, YouTube, or Kick who want music to match their workout intensity
- Athletes and runners who use Apple Music or Spotify during training
- Content creators looking for an automated, heart-rate-reactive music experience

## Key features

- Real-time BPM detection via HypeRate WebSocket
- Apple Music (MusicKit JS) and Spotify integration
- Up to 6 custom heart rate ranges with editable labels and BPM boundaries
- Auto-adjust range boundaries based on max heart rate
- Crossfade duration: 400 ms – 3 000 ms (configurable)
- Debounce: 1–15 seconds to prevent rapid switching
- OBS overlay with now-playing info and heart rate display
- Stream Deck plugin support (skip, pause, play, volume, range select)
- No backend data storage — all state is ephemeral and session-based

## Pages & Resources

- [Homepage](https://musicmatcher.hyperate.io/)
- [OBS Overlay](https://musicmatcher.hyperate.io/obs-overlay.html)
- [RSS Feed](https://musicmatcher.hyperate.io/feed.xml)
- [AI Summary](https://musicmatcher.hyperate.io/ai/summary.json)
- [AI FAQ](https://musicmatcher.hyperate.io/ai/faq.json)
- [AI Service Description](https://musicmatcher.hyperate.io/ai/service.json)
- [robots.txt](https://musicmatcher.hyperate.io/robots.txt)
- [Privacy Policy](https://www.iubenda.com/privacy-policy/74477999)
- [Terms and Conditions](https://www.iubenda.com/terms-and-conditions/74477999)
- [About / How it works](https://musicmatcher.hyperate.io/#about)

## Publisher

- [HypeRate — Heart Rate Sharing Platform](https://hyperate.io)
- [HypeRate on Twitter / X](https://twitter.com/HypeRateIO)
- [HypeRate on LinkedIn](https://www.linkedin.com/company/hyperate)
- [HypeRate on GitHub](https://github.com/HypeRate)
- [HypeRate on Crunchbase](https://www.crunchbase.com/organization/hyperate)