Heart-Rate Setup

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: docs.streamer.bot/guide/integrations/hyperate
Pulsoid Guide: 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

Account erstellen: www.hypewithpride.com: kostenloses Hobby-Account
Mobile App installieren: HypeRate iOS/Android
Heart Rate Device verbinden: Apple Watch / Wear OS / Bluetooth-HR-Strap
Session starten in der App → notier dir die ID (z.B. XYZA1234)
In Streamer.bot:
- Links Integrations → HypeRate.io
- HypeRate.io ID: Deine Session-ID eintragen
- Auto Connect: aktiv
- Auto Reconnect: aktiv
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

Account erstellen: pulsoid.net
Pulsoid App auf Smartphone → Heart-Rate-Device pairen
In Streamer.bot:
- Links Integrations → Pulsoid
- Button für OAuth-Connect → Browser öffnet sich → Pulsoid Login → bestätigen
- Auto Connect: aktiv
- 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

HypeRate.io Trigger: docs.streamer.bot/api/triggers/integrations/hyperateio/heart-rate-pulse
Pulsoid Trigger: docs.streamer.bot/api/triggers/integrations/pulsoid/heart-rate-pulse
HypeRate Setup Guide: docs.streamer.bot/guide/integrations/hyperate
Pulsoid Setup Guide: docs.streamer.bot/guide/integrations/pulsoid