STUNDENPLAN24 × HOME ASSISTANT

Dein Stundenplan.
Ein Teil deines
Zuhauses.

Unterricht, Vertretungen und Schulferien direkt auf deinem Dashboard. Für Schüler, Lehrkräfte und Familien, die ihren Alltag im Blick behalten möchten.

Open SourceHACS-IntegrationDE / EN / FR
HA STANDARD ha_default · Dunkel
Wochenplan im dunklen HA-Standard-Theme, Namen unkenntlich gemacht
BETA
Dein Plan. Klar im Blick.Wochenübersicht, Vertretungen und Ausfälle.
Von der Schule in dein Smart Home.Automatischer Datenabruf alle 15 Minuten ↗
AKTUELLE VERSIONENStable v2.6.5 ↗Beta v2.6.9-beta ↗Die passende Version für dein Setup.
HA STANDARD · ha_default

Ein Theme.
Zwei klare Ansichten.

Die aktuellen Beta-Karten in Home Assistant – hell und dunkel. theme: ha_default übernimmt die Darstellung deines aktiven HA-Themes.

01 — DIE KARTEN

So sieht dein
Stundenplan aus.

Hier laufen die Karten des main-Standes mit Beispieldaten. Die aktuellen Beta-Ansichten findest du in der Bildergalerie darüber. Wechsle die Ansicht, öffne eine Stunde oder probiere die mobile Darstellung aus.

INTERAKTIVE ORIGINALKARTEBeispieldaten

Eine Woche, fünf Tage und alle Änderungen. Klicke auf eine Unterrichtsstunde, um die Details zu sehen.

FÜR DEIN DASHBOARD

Deine Konfiguration.

Home Assistant → Dashboard bearbeiten → Karte hinzufügen → Manuell. YAML einfügen und die Entity-IDs prüfen.

02 — IM ALLTAG

Die Informationen,
die wirklich zählen.

VpMobile24 verbindet die Daten deiner Schule mit den Möglichkeiten von Home Assistant.

01

Änderungen erkennen.

Vertretungen und Ausfälle werden in den Karten gekennzeichnet. Fach, Lehrkraft, Raum und Zusatzinfos findest du in den Stundendetails.

Wochenplan ansehen ↗
02

Eine Karte für die Familie.

Mehrere Klassen erhalten eigene Sensoren. Die Mehrklassen-Karte bündelt ihre Stundenpläne in einer gemeinsamen Ansicht.

Mehrklassen-Karte ansehen ↗
03

Auch für Lehrkräfte.

Im Lehrermodus wird nach Lehrerkürzel gefiltert. Eigene Stunden, Vertretungen und vorhandene Pausenaufsichten bleiben zusammen im Blick.

Lehrermodus einrichten ↗
04

Ferien gehören dazu.

Wähle dein Bundesland für die Ferienerkennung. Die Karte zeigt eine eigene Ferienansicht. A/B-Wochen und Stunde 0 werden bei vorhandenen Schuldaten unterstützt.

Ferienansicht ansehen ↗

Dein Stundenplan kann Automationen auslösen.

Nutze die Sensoren etwa für eine morgendliche Übersicht oder eine Nachricht bei Planänderungen.

Beispiel öffnen ↗
03 — EINRICHTUNG

In drei Schritten
auf dein Dashboard.

Du brauchst Home Assistant, HACS und die Stundenplan24-Zugangsdaten deiner Schule. Alternativ ist eine manuelle Installation möglich.

1

Integration installieren.

Füge das Repository in HACS als Integration hinzu, lade VpMobile24 herunter und starte Home Assistant neu.

In HACS öffnen ↗
2

Mit deiner Schule verbinden.

Öffne Einstellungen → Geräte & Dienste → Integration hinzufügen → VpMobile24. Wähle Schüler, Lehrer oder Demo und trage Schul-ID, Passwort und Server ein.

Danach wählst du Klasse oder Lehrerkürzel, Fächer beziehungsweise Kurse und dein Bundesland.

3

Karte hinzufügen.

Die Integration liefert die Lovelace-Karten mit und registriert ihre Ressource. Füge die gewünschte Karte deinem Dashboard hinzu und wähle deine Sensoren aus.

Konfiguration erstellen ↗
Beta-Version installieren

Aktiviere für VpMobile24 in HACS die Anzeige von Beta-Versionen und wähle die gewünschte Vorabversion. Nach dem Update Home Assistant neu starten und das Dashboard neu laden.

Beta-Release-Notes ↗
Manuell installieren

Lade die gewünschte Version von GitHub herunter und kopiere custom_components/vpmobile24 nach config/custom_components/vpmobile24. Starte anschließend Home Assistant neu und richte die Integration ein.

Version herunterladen ↗
04 — DOKUMENTATION

Gut eingerichtet.
Schnell weiter.

Die wichtigsten Antworten direkt hier. Weitere Konfigurationsmöglichkeiten findest du in der Projekt-Dokumentation.

Vollständige Dokumentation ↗
Welche Sensoren stehen zur Verfügung?

Die genauen Entity-IDs hängen von deiner Einrichtung ab. Du findest sie unter Einstellungen → Geräte & Dienste → VpMobile24.

EntitätInhalt
WochentabelleStundenplan für die Wochenkarte
Nächste / übernächste WochePlan für kommende Wochen
Heutiger StundenplanAlle Stunden des Tages
Aktueller Unterricht / nächste StundeFach, Zeit, Lehrkraft und Raum
Änderungen / ZusatzinfosVertretungen, Ausfälle und Schulhinweise
FerienFerienstatus für das Bundesland
KalenderWochenplan in der Kalenderansicht
Beispiel: Bei Planänderungen benachrichtigen

Ersetze Sensor und Benachrichtigungsdienst durch deine eigenen Entitäten. Die Vorlage reagiert auf Zustandsänderungen des Änderungssensors.

alias: Stundenplanänderung melden
triggers:
  - trigger: state
    entity_id: sensor.vpmobile24_aenderungen
conditions:
  - condition: template
    value_template: >-
      {{ trigger.from_state is not none
         and trigger.to_state is not none
         and trigger.from_state.state not in ['unknown', 'unavailable']
         and trigger.to_state.state not in ['unknown', 'unavailable'] }}
actions:
  - action: notify.mobile_app_dein_handy
    data:
      title: Stundenplan aktualisiert
      message: Prüfe deinen Stundenplan auf Änderungen.
Die Karte erscheint nicht oder sieht veraltet aus

Starte nach Installation oder Update Home Assistant neu und lade das Dashboard neu. Prüfe unter Einstellungen → Dashboards → Ressourcen, ob die Kartenressource als JavaScript-Modul vorhanden ist:

/local/vpmobile24/vpmobile24-card.js

Falls nötig, ergänze die Ressource manuell. Leere bei weiterhin veralteter Anzeige den Browser- beziehungsweise Frontend-Cache.

Schule, Zugangsdaten und Server

VpMobile24 unterstützt Schulen, die Stundenplan24 beziehungsweise VpMobil nutzen. Schul-ID, Passwort und gegebenenfalls den Zusatzserver erhältst du von deiner Schule. Verwende den dort angegebenen Server.

Zugangsdaten und weitere Optionen kannst du über die Integration verwalten. Bei geändertem Passwort bietet die Integration eine erneute Authentifizierung an.

Ein Lehrerkürzel oder Kurs fehlt

Aktualisiere die Integration und öffne die Konfiguration erneut. Die Lehrerauswahl berücksichtigt Klassen- und Tagesplandaten. Wähle im Schülermodus die benötigten Parallel- und Oberstufenkurse in der Fächerauswahl aus.

Bei weiterhin fehlenden Daten helfen die XML-Rohdaten deiner Schule bei der Fehlersuche.

Anleitung für XML-Daten ↗
Mehrere Klassen und Lehrermodus einrichten

Füge VpMobile24 für jede gewünschte Klasse erneut hinzu. Gleiche Zugangsdaten können für unterschiedliche Klassen verwendet werden. Für Lehrkräfte wählst du beim Einrichten den Benutzertyp Lehrer und anschließend das eigene Kürzel.

DEIN NÄCHSTER SCHRITT

Bring deinen Schulalltag
auf dein Dashboard.

Jetzt einrichten ↗