HYPERATE MUSIC MATCHER

HypeRate Music Matcher is a free browser-based tool that bridges the gap between live biometric data and music streaming. It reads real-time heart rate data from a HypeRate session and automatically switches the Apple Music or Spotify playlist whenever beats-per-minute (BPM) crosses a configured boundary — with no manual interaction required.

Fitness streamers, marathon runners, and gym enthusiasts who want their workout soundtrack to match their effort level will find it removes the friction of manually changing tracks mid-set. Connect once, configure BPM thresholds, and let the heart rate lead the playlist.

After entering a HypeRate ID, the app opens a WebSocket connection and begins receiving live BPM updates. Apple Music connects through MusicKit JS — no separate backend required — while Spotify authorises via OAuth. Once connected, playlists can be dragged from the library onto each heart rate range.

The app monitors BPM continuously and triggers a playlist switch, complete with a configurable crossfade, whenever the listener moves from one range to another. A debounce timer (1–15 seconds, default 4 s) prevents rapid toggling when the heart rate fluctuates near a boundary.

Yes, completely free. No subscription, no login, no credit card required. An Apple Music or Spotify subscription is needed for music playback, and a HypeRate account is needed to share heart rate data.

Apple Music (via MusicKit JS) and Spotify are supported. Connect either service and use playlists from a personal library. Spotify support is currently in review by the Spotify API team.

Any heart rate monitor compatible with HypeRate works — including Apple Watch (via the HypeRate iOS app), Garmin wearables, Polar chest straps, Wahoo TICKR, and virtually any Bluetooth Low Energy (BLE) heart rate sensor. As long as HypeRate is broadcasting a live BPM signal, Music Matcher will respond to it.

Yes — it was built with live content creators in mind. The OBS browser-source overlay at /obs-overlay.html displays the currently playing track, artist name, album art, and live heart rate. Adding it as a browser source in OBS Studio lets the audience see full music context automatically.

For Elgato Stream Deck users, REST API endpoints (/sd/skip, /sd/pause, /sd/play, /sd/volumeup, /sd/zone/:id, and more) enable any playback action with a single button press, even while automatic heart-rate switching is active.

Up to six custom BPM ranges can be defined, each with a descriptive label (e.g. "Recovery", "Groove", "Beast Mode") and a playlist assignment. Ranges cannot overlap, and the app validates boundaries in real time. An auto-adjust button recalculates all boundaries based on the estimated maximum heart rate, following standard exercise physiology guidelines. Default ranges span 40–190 BPM across six graduated intensity levels.

Crossfade smoothly transitions audio between playlists when the heart rate changes range. Duration is configurable from 400 ms to 3 seconds. The debounce delay (1–15 seconds) prevents rapid toggling near a boundary. Both values are adjustable in the Settings panel without restarting the session.

No personal data is stored on disk. All session state — BPM history, playlist assignments, overlay data — lives in server memory, keyed by the HypeRate ID, and is automatically discarded after 24 hours of inactivity. Music authorisation tokens are handled entirely in the browser via Apple's MusicKit JS or Spotify's PKCE flow and never leave the device.