Formula 1 Smart-Home-Integration, kostenlos und Open Source
Nächster Grand Prix, Sessions in Ortszeit, Wertungen und Ergebnisse für Dashboard und Szenen.
Veröffentlicht von guim31
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.1.0
- ★ 0
Verfolge die Formel-1-Saison in Gladys: den nächsten Grand Prix mit allen Sessions in deiner Ortszeit, die Spitzenreiter der Meisterschaft, den letzten Sieger und, wenn du willst, deinen Lieblingsfahrer und dein Lieblingsteam. Ein Dashboard-Widget zeigt den Countdown, das Wochenende und die Wertung; Szenen-Auslöser melden sich vor einer Session und wenn die Ergebnisse da sind; Szenen-Aktionen liefern dir fertige Sätze zum Senden.
Die Daten kommen von Jolpica-F1, dem freien und kostenlosen Nachfolger der Ergast-API. Kein Konto, kein Schlüssel. Rückmeldungen sind im Gladys-Forum willkommen.
Was du brauchst
- Gladys 5.1.0 oder neuer.
- Internetzugang für Gladys: Die Integration liest
api.jolpi.ca.
Konfiguration
Speichere nach der Installation einmal die Konfiguration, öffne dann den Tab Entdecken und füge das Gerät Formel 1 hinzu. Die Schaltfläche Prüfen liest Jolpica-F1 neu und zeigt die Saison, den nächsten Grand Prix und deine Favoriten so, wie die Integration sie verstanden hat.
Sprache
Die Sprache der Funktionsnamen, der Session-Namen und der Sätze der Szenen (Gladys teilt einer Integration die Sprache ihrer Benutzer nicht mit). Die Funktionsnamen werden beim Hinzufügen des Geräts festgelegt: Um sie zu ändern, lösche das Gerät und füge es erneut hinzu. Das Widget folgt der Sprache der Person, die es ansieht. Namen von Grands Prix, Strecken, Fahrern und Teams bleiben so, wie Jolpica-F1 sie schreibt, auf Englisch.
Lieblingsfahrer und Lieblingsteam
Optional. Der Fahrer: sein Kürzel aus drei Buchstaben (VER), seine Startnummer (16), sein Nachname
(Hamilton) oder sein vollständiger Name. Das Team: sein Name (Ferrari, Red Bull, McLaren). Groß-
und Kleinschreibung sowie Akzente spielen keine Rolle. Ist einer gesetzt, bekommt das Gerät drei weitere
Funktionen (Position in der Meisterschaft, Punkte, letztes Ergebnis) und das Widget eine Kachel mit der
Position. Ein Name, der zu niemandem der laufenden Saison passt, wird im Verbindungsstatus gemeldet, und
Prüfen listet die Fahrer und Teams der Saison auf. Klicke nach dem Ändern eines Favoriten im Tab
Entdecken auf Aktualisieren, wenn Gladys es anbietet.
Das Gerät Formel 1
| Funktion | Wert |
|---|---|
| Nächster Grand Prix | sein Name; „Saison … beendet“ nach dem letzten Rennen |
| Strecke, Land | wo er stattfindet |
| Rennstart, Start des Qualifyings | Tag und Uhrzeit, in der Zeitzone von Gladys |
| Start des Sprints | Tag und Uhrzeit, oder „Kein Sprint“ |
| Nächste Session | die nächste Session des Wochenendes, oder das Rennen „läuft“ |
| Tage bis zum Rennen | 0 am Renntag |
| Lauf | der Lauf des nächsten Grand Prix |
| Rennwochenende | An vom Tag des ersten Trainings bis zum Renntag |
| Rennen heute | An am Renntag |
| Fahrer- / Konstrukteurs-Spitzenreiter | Name und Punkte |
| Letzter Sieger, Letztes Podium | des letzten Rennens mit veröffentlichten Ergebnissen |
| Lieblingsfahrer: … | Position, Punkte, letzter Grand Prix (0: nicht gewertet) |
| Lieblingsteam: … | Position, Punkte, bestes Auto im letzten Grand Prix (0: keins) |
Ein Grand Prix bleibt bis drei Stunden nach seinem Start der „nächste“. Die Werte werden von der Integration selbst aktualisiert (Gladys fragt dieses Gerät nicht ab) und zweimal am Tag neu veröffentlicht.
Dashboard-Widget
Füge das Widget Formel 1 zu einem Dashboard hinzu. Es zeigt den Namen des nächsten Grand Prix, den Countdown bis zum Rennen („10 T 5 h“, am Renntag dann Stunden und Minuten, dann „Läuft“), den Lauf, die Positionen deiner Favoriten, die Sessions des Wochenendes in deiner Ortszeit (die nächste hervorgehoben), die Top 5 der Fahrer- oder Konstrukteurswertung (eine Einstellung des Widgets) und das Podium des letzten Rennens.
Szenen-Auslöser
Session beginnt
Löst vor einer Session eines Grand-Prix-Wochenendes aus. Wähle die Sessions (1. bis 3. Freies Training, Sprint-Qualifying, Sprint, Qualifying, Rennen; leer: alle) und wann: beim Start oder 5, 15, 30 Minuten, 1 oder 2 Stunden vorher. Die Szene kann den Namen der Session, den Grand Prix, die Strecke, die Startzeit, die verbleibenden Minuten und den Lauf lesen.
Rennen beendet
Löst aus, wenn die Ergebnisse eines Grand Prix auf Jolpica-F1 veröffentlicht werden, meist einige Stunden nach der Zielflagge (die Integration prüft nach dem Rennen alle 10 Minuten). Die Szene kann einen zusammenfassenden Satz lesen („Max Verstappen (Red Bull) gewinnt den Singapore Grand Prix vor …“), den Grand Prix, den Sieger und sein Team, das Podium, die Position deines Lieblingsfahrers und die beste Position deines Lieblingsteams (0: nicht gewertet oder nicht gewählt).
Szenen-Aktionen
- Nächsten Grand Prix lesen: ein Satz wie „Nächster Grand Prix: United States Grand Prix, Lauf 18, Circuit of the Americas, Austin (Vereinigte Staaten). Rennen am Sonntag, 25. Oktober um 21:00, in 10 Tagen.“, dazu der Name, der Rennstart und die verbleibenden Tage (-1, wenn die Saison vorbei ist).
- Wertung lesen: die Spitze der Fahrer- oder Konstrukteurswertung (1 bis 10 Plätze) als Satz, dazu der Spitzenreiter und seine Punkte.
Beispiele für Szenen
- Nie wieder den Start verpassen: Auslöser „Session beginnt“, Sessions Qualifying und Rennen, 15 Minuten vorher → eine Nachricht mit Session, Grand Prix und Startzeit senden und den Fernseher einschalten.
- Bilanz am Sonntagabend: Auslöser „Rennen beendet“ → den zusammenfassenden Satz als Nachricht senden.
- Briefing am Montagmorgen: jeden Montag um 8:00 → „Nächsten Grand Prix lesen“ und „Wertung lesen“ → beide Sätze senden.
- Rennstimmung: Auslöser „Session beginnt“, Rennen, beim Start → das Licht im Wohnzimmer auf Rot stellen.
Fehlerbehebung
- Das Gerät zeigt nichts an: Füge es im Tab Entdecken hinzu und warte eine Minute. Sieh dir den Verbindungsstatus der Integration an: Er sagt, wenn Jolpica-F1 nicht erreichbar ist.
- „Lieblingsfahrer nicht gefunden“: Nutze Prüfen, das die Fahrer und Teams der Saison mit ihren Kürzeln auflistet.
- Ein Auslöser hat nicht ausgelöst: Eine Session ohne angekündigte Uhrzeit löst nichts aus; ein Auslöser, der verpasst wird, während Gladys oder die Integration nicht verfügbar ist, wird höchstens 10 Minuten lang nachgeholt und geht dann verloren. Direkt nach der Installation wird nichts nachgeholt.
- Die Ergebnisse kommen spät: Jolpica-F1 wird von Freiwilligen betrieben; die Ergebnisse erscheinen meist innerhalb weniger Stunden, manchmal am nächsten Tag. Die Integration prüft nach einem Rennen 48 Stunden lang weiter.
Grenzen
- Kein Live-Timing: Jolpica-F1 liefert Kalender, Ergebnisse und Wertungen, nicht das Geschehen während einer Session. Rote Flaggen und Safety-Cars bräuchten Live-Daten, die OpenF1 während einer Session nur zahlenden Nutzern gibt: Dafür gibt es keinen Auslöser.
- Sprint-Ergebnisse werden nicht verfolgt, nur die Ergebnisse der Grands Prix.
- Die Abrufe sind verteilt, um die Grenzen von Jolpica-F1 einzuhalten (4 Anfragen pro Sekunde, 500 pro Stunde): der Kalender einmal am Tag, Ergebnisse und Wertungen alle 6 Stunden, und nach einem Rennen alle 10 Minuten bis zu ihrer Veröffentlichung. Die Antworten werden im Datenordner der Integration zwischengespeichert: Gerät und Widget funktionieren weiter, wenn die API ausfällt.
- Die Namen (Grands Prix, Strecken, Fahrer, Teams) sind auf Englisch, so wie Jolpica-F1 sie veröffentlicht.
- Nach dem letzten Rennen der Saison melden „Nächster Grand Prix“ und „Nächste Session“ das Saisonende, die übrigen Funktionen des nächsten Rennens behalten aber die Werte des letzten Grand Prix bis zum nächsten Kalender.
- Eine Session ohne angekündigte Uhrzeit wird auf 12:00 UTC gesetzt: Weit weg von Europa kann ihr Tag um einen Tag abweichen, bis die Uhrzeit veröffentlicht ist.
Daten und Danksagungen
Kalender, Ergebnisse und Wertungen: Jolpica-F1 (Code unter Apache 2.0, Daten gemäß den Bedingungen des Projekts). Diese Integration ist weder mit der Formel 1 noch mit der FIA oder Jolpica-F1 verbunden. Formula 1 und F1 sind Marken der Formula One Licensing B.V.
Konfigurationseinstellungen
Diese Einstellungen fragt Formula 1 in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| So funktioniert es | section | Nein | Kalender, Ergebnisse und Wertungen kommen von Jolpica-F1, einer kostenlosen Open-Data-API: kein Konto, kein Schlüssel. Füge nach dem Speichern das Gerät Formel 1 im Tab „Entdecken“ hinzu, dann das Widget Formel 1 zu einem Dashboard. |
| Sprache der Texte | select | Nein | Namen der Funktionen, der Sessions und die Sätze der Szenen. Die Namen werden beim Hinzufügen des Geräts festgelegt. |
| Lieblingsfahrer | string | Nein | Optional. Kürzel, Nummer oder Name eines Fahrers der Saison (VER, 16, Hamilton). Das Gerät zeigt dann Position, Punkte und letztes Ergebnis. |
| Lieblingsteam | string | Nein | Optional. Name eines Teams der Saison (Ferrari, McLaren, Red Bull). Das Gerät zeigt dann Position, Punkte und bestes Ergebnis im letzten Rennen. |
So installierst du Formula 1 in Gladys
- Öffne in Gladys Integrationen: Formula 1 erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-f1: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-f1.
Formula 1 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
Formula 1 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