Zum Inhalt

Heart Rate Integration Setup (HypeRate + Pulsoid)

Du kannst deine Live-Herzfrequenz in Streamer.bot reinholen — entweder via HypeRate.io oder Pulsoid. Beide Dienste empfangen Daten von Fitness-Geräten (Apple Watch, Wear OS, Garmin, Polar etc.) und streamen sie an Streamer.bot weiter.

Doku: - HypeRate Guide: https://docs.streamer.bot/guide/integrations/hyperate - Pulsoid Guide: https://docs.streamer.bot/guide/integrations/pulsoid

HypeRate vs Pulsoid

HypeRate.io Pulsoid
Auth Session-ID (einfach) OAuth (sicherer)
Kostenlos? Free + Paid Tiers Free Tier verfügbar
Geräte Apple Watch, Wear OS, Bluetooth Apple Watch, Wear OS, Garmin, Polar
Reconnect gut gut
Update-Rate bis 1/sec bis 1/sec
Test-Modus internal-testing ID –

Empfehlung für Hobby-Streamer: HypeRate (einfacher Setup). Für Pro: Pulsoid (OAuth + mehr Features).

HypeRate.io Setup

  1. Account erstellen: https://www.hypewithpride.com/ — kostenloses Hobby-Account
  2. Mobile App installieren: HypeRate iOS/Android
  3. Heart Rate Device verbinden: Apple Watch / Wear OS / Bluetooth-HR-Strap
  4. Session starten in der App → notier dir die ID (z.B. XYZA1234)
  5. In Streamer.bot:
  6. Links Integrations → HypeRate.io
  7. HypeRate.io ID: Deine Session-ID eintragen
  8. Auto Connect: aktiv
  9. Auto Reconnect: aktiv
  10. SB sollte sich sofort verbinden — Status im Pane checken

Test ohne echtes Device: internal-testing als ID eintragen → SB bekommt Fake-Daten zum Testen.

Pulsoid Setup

  1. Account erstellen: https://pulsoid.net/
  2. Pulsoid App auf Smartphone → Heart-Rate-Device pairen
  3. In Streamer.bot:
  4. Links Integrations → Pulsoid
  5. Button für OAuth-Connect → Browser öffnet sich → Pulsoid Login → bestätigen
  6. Auto Connect: aktiv
  7. Auto Reconnect: aktiv

Pulsoid braucht kein manueller Token — OAuth macht das.

Trigger-Variablen

Beide Integrationen feuern den Heart Rate Pulse Trigger:

Integration Pfad Variablen
HypeRate Integrations → HypeRate.io → Heart Rate Pulse %heartRate% (int)
Pulsoid Integrations → Pulsoid → Heart Rate Pulse %heartRate% (int), %measuredAt% (Unix-Timestamp)

Plus alle General-Variables (%timestamp%, %actionId%, etc.).

WICHTIG: Performance

Der Heart Rate Pulse Trigger feuert bis zu 1× pro Sekunde. Das ist viel.

Empfehlungen:

  • Action-Queue: Im Action-Editor unter Settings → Queue eine separate Queue verwenden — sonst blockieren Heart-Rate-Updates andere Actions
  • Blocking Queue aktiv damit Heart-Rate-Action nicht backlog't bei langsamen Sub-Actions
  • Kein Send Message bei jedem Pulse — sonst spamt der Bot den Chat. Nur bei Schwellwert-Überschreitung (siehe heart-rate-zones.md)
  • OBS-Text-Source updates sind ok — schnell und non-blocking (siehe heart-rate-display.md)

Range-Filter im Trigger

Der Trigger hat eingebaute Min/Max-Filter. So feuerst du Action nur bei bestimmten Bereichen:

Filter Bedeutung
Min 100, Max leer nur bei HR ≥ 100
Min leer, Max 60 nur bei HR ≤ 60
Min 150, Max 200 nur bei HR 150-200
Beide leer bei JEDEM Pulse

So splittest du verschiedene Actions pro Zone (Resting/Active/High/Stress).

Use-Cases in dieser Sektion

Use-Case MD
Live-HR in OBS Text-Source anzeigen heart-rate-display.md
Trigger bei Schwellwerten (Stress-Modus über 150) heart-rate-zones.md
Min/Max/Avg pro Stream tracken heart-rate-stats.md

Häufige Fallen

  • Session-ID läuft ab (HypeRate Free) — alle paar Stunden neu starten. Pulsoid hat persistente Token
  • HR-Device Bluetooth-Drop — Stream-PC und Watch zu weit weg → keine Daten. Auto-Reconnect rettet meist
  • Action Queue voll — wenn jede Sekunde was schweres läuft (z.B. Discord-Webhook), backlog wächst. Lösung: Throttling oder nur bei Range-Match
  • Privacy — Heart Rate ist sensitiv. Wer das im Stream zeigt, sollte sich bewusst sein dass es Stress-Level, Aufregung, etc. verrät

Quellen