Flair Smart-Home-Integration, kostenlos und Open Source

Steuere Flair Smart Vents, Raum-Sollwerte und Zuhause/Abwesend, lies die Flair Pucks.
Steuere deine Flair Smart Vents (smarte Lüftungsklappen) aus Gladys, verfolge die Temperatur jedes Raums und schalte dein Zuhause zwischen Zuhause und Abwesend um.
Was du bekommst
Nach der Konfiguration listet der Tab Erkennung ein Gerät pro Flair-Element:
| Flair-Element | In Gladys |
|---|---|
| Zuhause | Schalter Zuhause (aus = Abwesend), Auto-Modus (aus = Manuell) |
| Raum | Sollwert (Thermostat), Temperatur, Luftfeuchtigkeit, Aktiv |
| Smart Vent | Öffnung (0 % zu bis 100 % offen) und die Tasten Öffnen / Schließen |
| Puck | Temperatur, Luftfeuchtigkeit |
Jedes Gerät zeigt ein Cloud-Abzeichen: Flair ist nur über seine Cloud erreichbar. Das Abzeichen wechselt auf nicht erreichbar, wenn Flair nicht antwortet oder wenn sich eine Klappe oder ein Puck nicht mehr meldet (leere Batterie, außer Reichweite).
Vorab: API-Zugangsdaten besorgen
Flair gibt den API-Zugang auf Anfrage frei: Schreibe dem Flair-Support (über die Flair-Website oder die Flair-App) und bitte um API-Zugangsdaten für dein Konto. Du erhältst eine Client-ID und ein Client-Secret.
Konfiguration
- Öffne den Tab Konfiguration der Integration.
- Füge die Client-ID und das Client-Secret ein.
- Ändere bei Bedarf das Aktualisierungsintervall: Die Integration liest dein Flair-Konto standardmäßig alle 2 Minuten (mindestens eine Minute).
- Speichere und klicke auf Verbindung testen: Die Antwort listet die gefundenen Zuhause, Räume, Klappen und Pucks.
- Öffne den Tab Erkennung und füge die gewünschten Geräte hinzu.
Gut zu wissen
- Im Auto-Modus öffnet und schließt Flair die Klappen selbst, um den Sollwert jedes Raums zu erreichen. Eine in Gladys gesetzte Öffnung hält bis zur nächsten Entscheidung von Flair. Damit die Klappen bleiben, wo du sie hinstellst, schalte das Zuhause auf Manuell (Schalter Auto-Modus).
- Ein inaktiver Raum wird von Flair ausgelassen: Seine Klappen bleiben geschlossen.
- Eine Änderung in der Flair-App erscheint bei der nächsten Aktualisierung in Gladys.
Szenen
Die Integration fügt dem Szenen-Editor eigene Karten hinzu, in der Kategorie Integrationen.
Auslöser:
- Flair Zuhause/Abwesend geändert — ein Zuhause wechselte zwischen
Zuhause und Abwesend (Flair-App, Geofencing oder Gladys … außer einer
Änderung durch dieselbe Szene). Wähle optional das Zuhause und den neuen
Modus. Die folgenden Aktionen können
{{triggerEvent.data.mode}}(homeoderaway) und{{triggerEvent.data.home_name}}lesen. - Flair-Gerät online oder offline — eine Klappe oder ein Puck meldet sich
nicht mehr oder ist zurück. Wähle optional das Gerät und den Status.
Variablen:
{{triggerEvent.data.status}}(offlineoderonline) und{{triggerEvent.data.device_name}}.
Aktionen:
- Öffnung einer Flair-Klappe setzen — 0 bis 100 %. Gibt die Öffnung zurück und ob das Zuhause im Auto-Modus ist (Flair kann die Klappe dann wieder verstellen).
- Sollwert eines Flair-Raums setzen — 10 bis 32 °C. Gibt den Sollwert zurück.
- Flair-Zuhause auf Zuhause oder Abwesend setzen — gibt zurück, ob das Zuhause auf Zuhause steht.
- Flair-Zuhause auf Auto oder Manuell setzen — gibt zurück, ob Auto aktiv ist.
Dashboard
Füge das Widget Flair-Übersicht einem Dashboard hinzu. Es zeigt die durchschnittliche Raumtemperatur, die Zahl der offenen Klappen, die Offline-Geräte, dann jedes Zuhause (Zuhause / Abwesend, Auto / Manuell) und jeden Raum (Temperatur → Sollwert, grün wenn nah, orange oder rot wenn weit entfernt). Seine Tasten schalten das erste Zuhause zwischen Zuhause und Abwesend, zwischen Auto und Manuell um und aktualisieren die Daten sofort.
Fehlerbehebung
- „Flair hat die API-Zugangsdaten abgelehnt“ — prüfe Client-ID und Client-Secret, ohne Leerzeichen davor oder danach. Wende dich an den Flair-Support, wenn es weiterhin scheitert.
- „Die Flair-Cloud antwortet nicht“ — Flair oder deine Internetverbindung ist ausgefallen. Die Integration versucht es bei jeder Aktualisierung erneut.
- Ein Gerät bleibt nicht erreichbar — prüfe in der Flair-App seine Batterie und seinen Abstand zur Flair-Bridge.
- Mehr Details in den Logs der Integration (Gladys-Oberfläche oder
docker logsauf dem Host), mitLOG_LEVEL=debug.
Konfigurationseinstellungen
Diese Einstellungen fragt Flair in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Erste Schritte | section | Nein | Flair wird über seine Cloud-API mit OAuth-2.0-Zugangsdaten (Client-ID und Client-Secret) gesteuert, die der Flair-Support auf Anfrage ausstellt. Gib sie unten ein, speichere und klicke auf „Verbindung testen“: Deine Zuhause, Räume, Klappen und Pucks erscheinen im Tab „Erkennung“. |
| Client-ID | string | Ja | OAuth-2.0-Client-ID der Flair-API. |
| Client-Secret | secret | Ja | OAuth-2.0-Client-Secret der Flair-API. Als Geheimnis gespeichert, nie protokolliert. |
| Aktualisierungsintervall (s) | number | Nein | Wie oft das Flair-Konto gelesen wird, in Sekunden (mindestens eine Minute). |
So installierst du Flair in Gladys
- Öffne in Gladys Integrationen: Flair erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/prohand/gladys-flair:1.0.1) 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/prohand/gladys-flair.
Flair benötigt Gladys >=5.3.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
Flair 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 prohand 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