Ultrahuman Ring

Liest Gesundheitsdaten vom Ultrahuman Ring über die Partner API

Aktueller Release
0.1.13
Entwickler
SmarterPapa
Lizenz
MIT

SmarterPapa

Ultrahuman

ioBroker.ultrahuman

Aktuelle Adapterversion: 0.1.13

Ultrahuman Ringadapter für ioBroker

Dieser Adapter liest Gesundheitsmetriken von Ihrem Ultrahuman Ring über die Ultrahuman Partner API und erstellt ioBroker-Objekte, die Sie in Visualisierungen, Skripten und Automatisierungen verwenden können.

Ausführlicher Leitfaden (deutsch): Ultrahuman Ring im ioBroker – Schlaf, HRV & Gesundheitsdaten (SmarterPapa.de) – Installation, alle Datenpunkte, Automatisierungsbeispiele, FAQ.

Quellcode: GitHub

Betreuer: Vertrauenswürdige Herausgeber aktivieren füriobroker.ultrahuman (dieses GitHub-Repository). Releases verwendenioBroker/testing-action-deploy@v1 auf Node.js 24 nur mit OIDC (keinnpm-token Siehe testing-action-deploy#19 .

Installation

Installieren Sie den Adapter über die ioBroker-Admin-Oberfläche:

  1. Adapter in ioBroker Admin öffnen
  2. Suche nach Übermenschen
  3. Klicken Sie auf Installieren.

Verfügbare Metriken

KanalZustandBeschreibungEinheit
sleepbedtimeStartZeit, dass du ins Bett gegangen bistISO 8601
sleepbedtimeEndZeit, dass du aufgestanden bistISO 8601
sleeptimeInBedGesamte Zeit im Bettmin
sleeptimeAsleepGesamtschlafzeitmin
sleeptimeToFallAsleepWie lange es dauerte, bis ich einschliefmin
sleepsleepEfficiencySchlafeffizienz%
sleepsleepScoreSchlafbewertung
sleepsleepQualitySchlafqualität (ausgezeichnet/gut/mittelmäßig/schlecht)
sleepremSleepREM-Schlafdauermin
sleepdeepSleepTiefschlafdauermin
sleeplightSleepDauer des leichten Schlafsmin
sleeprestorativeSleepErholungsschlaf (REM + Tiefschlaf)%
sleepsleepCyclesVollständige Schlafzyklen
heartrestingHRRuhepuls (Schlaf)bpm
heartnightRHRRuhepuls in der Nachtbpm
heartlastReadingLetzter HR-Wertbpm
heartavg /min /maxHerzfrequenzstatistikbpm
hearttrendHerzfrequenztrend
hrvaverageDurchschnittliche HRVMS
hrvsleepHRVDurchschnittliche Schlaf-HRVMS
hrvmin /maxHRV-StatistikenMS
hrvtrendHRV-Trend
spo2avg /min /maxBlutsauerstoffstatistik%
temperaturelastReadingLetzte Hauttemperatur°C
temperatureavg /min /maxTemperaturstatistik°C
activitystepsSchritte heute insgesamtSchritte
activitystepsAvgDurchschnittliche SchritteSchritte
activityactiveMinutesAktive Minutenmin
activitymovementIndexBewegungsindex
activityrecoveryIndexErholungsindex
activityvo2MaxVO2 maxml/kg/min
infoconnectionAPI-Verbindungsstatusboolescher Wert
infolastUpdateLetzte erfolgreiche AktualisierungISO 8601

Voraussetzungen

Sie benötigen Zugriff auf die Ultrahuman Partner API :

  1. Senden Sie eine E-Mail an feedback@ultrahuman.com und beantragen Sie API-Zugriff für den persönlichen Gebrauch.
  2. Sie erhalten einen API-Schlüssel und einen Zugriffscode .
  3. In der Ultrahuman-App gehen Sie zu Profil > Einstellungen > Partner-ID und geben den Zugangscode ein.
  4. Konfigurieren Sie den API-Schlüssel und Ihre Konto-E-Mail-Adresse in den Adaptereinstellungen.

Konfiguration

EinstellungBeschreibungStandard
API-GeheimnisIhr Ultrahuman Partner API-Autorisierungsschlüssel—
Benutzer-E-MailE-Mail-Adresse, die mit Ihrem Ultrahuman-Konto verknüpft ist—
AbstimmungsintervallWie oft sollen die Daten abgerufen werden (Minuten)?30

Das minimale Abfrageintervall beträgt 5 Minuten. Da die Ringdaten periodisch (nicht in Echtzeit) synchronisiert werden, werden 30 Minuten empfohlen.

Unterstützung

Wenn Sie diesen Adapter nützlich finden, erwägen Sie, die Entwicklung zu unterstützen:

ko-fi

Danksagungen

API-Integration basierend auf ultrahuman-dashboard von Matt Krainski (MIT-Lizenz).

Changelog

0.1.13 (2026-04-11)

  • Deploy uses Node.js 24 with testing-action-deploy@v1; Trusted Publishing only (no npm-token), per maintainer note on testing-action-deploy#19

0.1.12 (2026-04-10)

  • 0.1.12: testing-action-deploy@v1 with npm-token again (OIDC-only path breaks on ubuntu-latest during global npm upgrade); README documents W3019 trade-off
  • common.news trimmed to seven entries (W1032); 0.1.3 moved to history only via CHANGELOG_OLD.md

0.1.11 (2026-04-09)

  • GitHub Releases: ioBroker/testing-action-deploy@v1 with granular NPM_TOKEN (Bypass 2FA)
  • Changelog lists 0.1.11 here; older releases in CHANGELOG_OLD.md
  • Dependabot default cooldown 7 days; includes 0.1.9–0.1.10 fixes (integration tests, Admin jsonConfig)

0.1.8 (2026-03-27)

  • io-package.json common.news reduced to 7 entries (ioBroker repository checker W1032)

0.1.7 (2026-03-26)

  • Package homepage (npm) points to the detailed German blog guide on SmarterPapa.de
  • README and ioBroker Admin (About tab) link to the same article; GitHub remains the repository URL

Older versions: CHANGELOG_OLD.md.

License

MIT License — see LICENSE for details.

Copyright (c) 2026 SmarterPapa