Habitica Smart-Home-Integration, kostenlos und Open Source
Habitica in Gladys: Lebenspunkte, Stufe, offene Tägliche, abhaken per Szene oder Dashboard.
Veröffentlicht von guim31
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.1.0
- ★ 0
Hol deinen Habitica-Charakter in Gladys: Lebenspunkte, Stufe, Erfahrung, Gold, die heute offenen Täglichen und die überfälligen To-dos. Eine Szene erinnert dich abends an noch nicht abgehakte Tägliche, feiert eine neue Stufe oder warnt bei niedrigen Lebenspunkten; ein NFC-Tag an der Trinkflasche zählt eine Gewohnheit, ein Tippen auf dem Dashboard hakt eine Tägliche ab, und Gladys kann jeden Abend vorlesen, was noch offen ist.
Funktioniert mit habitica.com und mit einem selbst gehosteten Habitica.
Feedback willkommen. Diese Integration wurde mit einem echten, selbst gehosteten Habitica-Server getestet (Habitica 5.51.0 in Docker, Oktober 2026), noch nicht im Alltag und nicht mit habitica.com. Wenn etwas nicht wie beschrieben funktioniert, sag es im Gladys-Forum oder in den Issues.
Was du brauchst
- Gladys Assistant 5.1.0 oder neuer.
- Ein Habitica-Konto, auf habitica.com oder auf deinem eigenen Server.
- Seine Benutzer-ID und sein API-Token: in Habitica Einstellungen → Seitendaten → API (in der mobilen App: Einstellungen → API), dann API-Token anzeigen. Das Token gibt vollen Zugriff auf das Konto: Behalte es für dich und setze es an derselben Stelle zurück, falls es bekannt wird.
Einrichtung
- Installiere die Integration aus dem Store (Integrationen → Habitica).
- In Konfiguration:
- Adresse: Behalte
https://habitica.comoder gib die Adresse deines eigenen Servers ein (z. B.http://192.168.1.20:3000). - Benutzer-ID und API-Token: aus Habitica kopiert.
- Selbstsignierte Zertifikate akzeptieren: nur für eine
https://-Adresse deines eigenen Servers mit selbstsigniertem Zertifikat. - Schwelle für niedrige Lebenspunkte (standardmäßig 15, von 50): die Schwelle des Ereignisses „Habitica-Lebenspunkte niedrig“.
- Erinnerung an offene Tägliche: wie viele Stunden vor dem Ende des Habitica-Tages das Ereignis „Habitica-Tägliche noch offen“ ausgelöst wird (standardmäßig 2).
- Aktualisierungsintervall: standardmäßig 5 Minuten, bis zu 30.
- Sprache der Funktionsnamen: die Namen der Funktionen beim Hinzufügen des Geräts und die an Szenen gesendeten Sätze.
- Adresse: Behalte
- Nutze Verbindung testen: Es zeigt den Namen deines Charakters, seine Stufe und die heute offenen Täglichen.
- Füge unter Erkennung das Gerät Habitica <Name> hinzu.
Der Habitica-Tag beginnt zur Stunde des eigenen Tagesbeginns deines Kontos (Einstellungen → Seitendaten in Habitica), in der Zeitzone von Gladys.
Geräte
Ein Gerät, Habitica <Name des Charakters>, mit diesen Funktionen:
| Funktion | Was sie zählt |
|---|---|
| Lebenspunkte | von 0 bis 50, aufgerundet wie in Habitica |
| Stufe | die Stufe des Charakters |
| Erfahrung | die Erfahrungspunkte innerhalb der Stufe |
| Gold | das Gold, abgerundet |
| Offene Tägliche | heute fällige und noch nicht abgehakte Tägliche |
| Überfällige To-dos | offene To-dos, deren Fälligkeitsdatum vor heute liegt |
Solange du Habitica an einem neuen Tag nicht geöffnet hast (oder „Habitica-Tag beginnen“ genutzt hast), hat der neue Tag in Habitica nicht begonnen: Alle Täglichen des Tages zählen dann als offen, da Habitica sie gleich alle zurücksetzt.
Die Werte folgen dem Aktualisierungsintervall, und jede Aktion aus Gladys aktualisiert sie sofort.
Dashboard
Das Widget Habitica-Tägliche zeigt die offenen Täglichen und deine Lebenspunkte, die Liste der offenen Täglichen und danach der überfälligen To-dos, sowie eine Taste zum Abhaken jeder der ersten vier offenen Täglichen. Wenn der neue Tag in Habitica noch nicht begonnen hat, sagt es das und bietet stattdessen die Taste Meinen Tag beginnen an: Ein Abhaken würde sonst für gestern zählen.
Szenen
Auslöser
- Habitica-Tägliche noch offen: wird für jede noch nicht abgehakte Tägliche ausgelöst, die eingestellte Anzahl Stunden vor dem Ende des Habitica-Tages. Filter: der Titel der Täglichen (leer: beliebig). Variablen: die Tägliche, ihre ID, die Anzahl offener Täglicher, die Stunden bis zum Tagesende.
- Habitica-Stufe aufgestiegen: Der Charakter hat eine neue Stufe erreicht. Variablen: die Stufe, die vorherige Stufe, die Klasse.
- Habitica-Lebenspunkte niedrig: Die Lebenspunkte sind unter die Schwelle der Konfiguration gefallen. Einmal pro Unterschreiten. Variablen: Lebenspunkte, Schwelle, Stufe.
- Alle Habitica-Täglichen erledigt: Die letzte Tägliche des Tages wurde gerade abgehakt, in Habitica oder aus Gladys. Variable: die Anzahl der Täglichen des Tages.
Die Ereignisse werden bei jedem Lesen erkannt: bis zu einem Aktualisierungsintervall später für Stufe, Lebenspunkte oder die letzte Tägliche; die Erinnerung kommt immer pünktlich.
Aktionen
- Habitica-Aufgabe abhaken: per genauem Titel (Groß- und Kleinschreibung und Akzente egal) oder ID: eine Gewohnheit + oder −, eine Tägliche, ein To-do. Die Richtung „−“ zählt eine schlechte Gewohnheit oder setzt eine abgehakte Tägliche zurück. Hat der neue Tag in Habitica noch nicht begonnen, wird er zuerst begonnen. Ausgaben: die Aufgabe, ihr Typ, Lebenspunkte, Stufe und Gold danach.
- Habitica-To-do erstellen: fügt dem Konto ein To-do hinzu. Ausgaben: das To-do und seine ID.
- Habitica-Tag beginnen: was Habitica macht, wenn du es an einem neuen Tag öffnest: Die gestern verpassten Täglichen richten ihren Schaden an, dann werden alle Täglichen zurückgesetzt.
- Habitica lesen: die offenen Täglichen, die überfälligen To-dos und die Lebenspunkte als Satz, für eine Nachricht oder eine Sprachansage. Ausgaben: der Satz, die offenen Täglichen, die überfälligen To-dos, Lebenspunkte und Stufe.
Szenen-Ideen
- Habitica-Tägliche noch offen (um 22 Uhr: 2 Stunden vor Mitternacht) → „{{triggerEvent.data.task}} ist noch offen“ per Telegram senden.
- Ein NFC-Tag an der Trinkflasche → Habitica-Aufgabe abhaken „Ein Glas Wasser trinken“.
- Alle Habitica-Täglichen erledigt → das Wohnzimmerlicht eine Minute grün leuchten lassen.
- Jeden Morgen um 7 Uhr → Habitica-Tag beginnen, dann Habitica lesen und den Satz über den Lautsprecher sagen.
Fehlerbehebung
- „Benutzer-ID oder API-Token abgelehnt“: Kopiere sie erneut aus Einstellungen → Seitendaten → API. Ein zurückgesetztes Token musst du neu eingeben.
- „Habitica antwortet nicht“: Prüfe bei deinem eigenen Server Adresse und Port, von Gladys aus erreichbar.
- „keine Habitica-API unter dieser Adresse“: Die Adresse zeigt auf etwas anderes, oder es fehlt das Pfadpräfix deines Reverse-Proxys.
- „zu viele Anfragen“: habitica.com erlaubt 30 Anfragen pro Minute und Konto, geteilt mit allen Tools, die du nutzt. Die Integration wartet und versucht es erneut.
- Die offenen Täglichen sehen aus wie gestern: Der neue Tag hat in Habitica noch nicht begonnen; öffne Habitica oder nutze „Meinen Tag beginnen“.
- Mehr Details mit der Protokollstufe
debugin den Einstellungen der Integration.
Grenzen
- Ein Habitica-Konto pro Installation.
- Belohnungen werden weder angezeigt noch gekauft, und die Checklisten-Punkte einer Aufgabe werden nicht angezeigt.
- Zwei Aufgaben mit demselben Titel lassen sich nicht per Titel unterscheiden: Nutze die ID der Aufgabe (Bearbeitungsansicht der Aufgabe in Habitica) oder benenne eine um.
- Der Habitica-Tag folgt der Zeitzone von Gladys: Ist dein Habitica-Konto auf eine andere eingestellt, folgen Tagesbeginn und Erinnerung Gladys.
- Die Bedingungen von Habitica verlangen von Tools, deutlich unter 30 Anfragen pro Minute zu bleiben: Die Integration macht 2 Anfragen pro Aktualisierung (höchstens alle 5 Minuten), plus etwa 5 pro Aktion.
- Nicht mit HabitRPG, Inc. verbunden.
Konfigurationseinstellungen
Diese Einstellungen fragt Habitica in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Habitica-Konto | section | Nein | Auf habitica.com oder deinem eigenen Server. Benutzer-ID und API-Token findest du in Habitica: Einstellungen, Seitendaten, API. |
| Adresse | string | Nein | Behalte https://habitica.com oder gib die Adresse deines selbst gehosteten Habitica ein. |
| Benutzer-ID | string | Ja | Einstellungen, Seitendaten, API: Benutzer-ID. |
| API-Token | secret | Ja | Einstellungen, Seitendaten, API: API-Token (API-Token anzeigen). Es gibt vollen Zugriff auf das Konto. |
| Selbstsignierte Zertifikate akzeptieren | boolean | Nein | Für eine https://-Adresse mit selbstsigniertem Zertifikat. Nur für deinen eigenen Server aktivieren. |
| Optionen | section | Nein | |
| Schwelle für niedrige Lebenspunkte | number | Nein | Das Ereignis „Habitica-Lebenspunkte niedrig“ wird ausgelöst, wenn die Lebenspunkte unter diesen Wert fallen (von 50). |
| Erinnerung an offene Tägliche | select | Nein | Wann das Ereignis „Habitica-Tägliche noch offen“ ausgelöst wird, vor dem Ende des Habitica-Tages (eigener Tagesbeginn). |
| Aktualisierungsintervall | select | Nein | Wie oft Habitica gelesen wird. Erinnerung und Tagesbeginn werden immer pünktlich berücksichtigt. |
| Sprache der Funktionsnamen | select | Nein | Namen der Funktionen beim Hinzufügen des Geräts und an Szenen gesendete Texte. |
So installierst du Habitica in Gladys
- Öffne in Gladys Integrationen: Habitica erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-habitica:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-habitica.
Habitica benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Habitica ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation