{
  "faqs": [
    {
      "question": "What is HypeRate Music Matcher?",
      "answer": "HypeRate Music Matcher is a free web app that reads your live heart rate via HypeRate and automatically switches your Apple Music or Spotify playlist based on your BPM. You assign playlists to heart rate zones, and the app handles the rest — no manual control needed during your workout or stream."
    },
    {
      "question": "How does HypeRate Music Matcher work?",
      "answer": "You enter your HypeRate ID, connect Apple Music or Spotify, and assign a playlist to each heart rate zone (e.g. 60–100 BPM = Chill, 100–150 BPM = EDM, 150+ BPM = Hardcore). The app listens to your live BPM via a WebSocket connection to HypeRate and automatically switches playlists when your heart rate crosses a zone boundary."
    },
    {
      "question": "Is HypeRate Music Matcher free?",
      "answer": "Yes, completely free. No subscription, no login, no credit card required. You only need an Apple Music or Spotify subscription for music playback, and a HypeRate account to share your heart rate."
    },
    {
      "question": "Which music services are supported?",
      "answer": "HypeRate Music Matcher supports Apple Music (via MusicKit JS) and Spotify. You can connect either service and use playlists from your library."
    },
    {
      "question": "What heart rate devices are compatible?",
      "answer": "Any device that works with HypeRate is compatible — including Apple Watch, Garmin, Polar, Wahoo, and most Bluetooth Low Energy (BLE) heart rate monitors and chest straps."
    },
    {
      "question": "Can I use it while streaming on Twitch or YouTube?",
      "answer": "Yes! HypeRate Music Matcher is designed for streamers. It includes an OBS browser-source overlay that shows the current track, album art, and your heart rate live on stream. It also supports Elgato Stream Deck via API endpoints for manual skip, pause, play, and zone switching."
    },
    {
      "question": "How many heart rate zones can I configure?",
      "answer": "You can configure up to 6 custom heart rate zones. Each zone has an editable label, minimum BPM, and maximum BPM. Zones cannot overlap and must cover adjacent BPM ranges."
    },
    {
      "question": "What is the crossfade feature?",
      "answer": "Crossfade smoothly transitions between playlists when your heart rate changes zones. You can set the crossfade duration from 400 milliseconds to 3 seconds. There is also a debounce delay (1–15 seconds) to prevent rapid switching if your heart rate fluctuates near a boundary."
    },
    {
      "question": "Does it work with Stream Deck?",
      "answer": "Yes. HypeRate Music Matcher exposes a REST API that the Elgato Stream Deck plugin can call. Supported commands include skip, pause, play, toggle, volume up/down, stop, and direct zone switching."
    },
    {
      "question": "Is any data stored on the server?",
      "answer": "No. All session state (zones, playlists, overlay data) is held in memory and associated with your HypeRate ID. Sessions are automatically cleared after 24 hours of inactivity. No personal data is stored on disk."
    }
  ]
}