VpMobile24 – Home Assistant Integration

Features

Alles was du brauchst

VpMobile24 bringt deinen Stundenplan direkt in Home Assistant – mit modernem Navy-Design, smarten Funktionen und vollständiger Mehrsprachigkeit.

🃏

Lovelace Card

Visuell, interaktiv, responsiv

Wochenübersicht – Mo–Fr auf einen Blick, heutiger Tag blau hervorgehoben

Aktuelle Stunde grün – automatisch anhand der Uhrzeit erkannt

Ausfallstunden rot – in allen Spalten, klickbar mit AUSFALL-Popup

Vertretungen – dunkelrot markiert, Popup mit Lehrer & Raum

Pausen hervorgehoben – blauer Balken zwischen den Stunden

ⓘ Zusatzinfos – pulsierender Button, zeigt Tagesinfos per Klick

Nächste Woche – Button zum Anzeigen der nächsten Woche, am WE automatisch

Aktueller Unterricht Widget – zeigt die laufende Stunde als kompakte Card

Mehrere Klassen – Vergleichsansicht für mehrere Klassen in einer Card

📱

Mobil & Design

Navy-Design, überall nutzbar

Navy Dark Design – modernes #0f1729 Farbschema, kein HA-Theme

Handy-Modus – Einzelspalte mit Tab-Navigation (Mo/11, Di/12 …)

Tab-Persistenz – gewählter Tag bleibt auch bei HA-Updates erhalten

Popup bleibt offen – kein Schließen beim automatischen Daten-Update

Datum in Spaltenköpfen – Tag + Datum (Mo / 11) auf einen Blick

⚙️

Integration

Automatisch, mehrsprachig, flexibel

Mehrere Klassen – gleiche Zugangsdaten, eigene Geräte pro Klasse

Auto-Refresh – Daten alle 15 Minuten, manueller Reload-Button

Vollständig mehrsprachig – DE / EN / FR, automatisch aus HA-Sprache

Fächer ausschließen – unerwünschte Fächer beim Setup herausfiltern

Klasse & Fächer ändern – nachträglich per ⚙️ Konfigurieren, unabhängig voneinander

Klassenauswahl aus XML – beim Setup automatisch alle Klassen der Schule laden

Countdown bis nächste Stunde – Sensor zeigt „in 23 Min." für Automationen

Eigene Uhrzeiten – Stunden- und Pausenzeiten visuell konfigurierbar

HACS-kompatibel – einfache Installation und automatische Updates

Installation

In 3 Schritten startklar

Wähle deine bevorzugte Installationsmethode. HACS ist der empfohlene Weg.

1

HACS öffnen & Repository hinzufügen

Wähle eine der folgenden Methoden um VpMobile24 in HACS hinzuzufügen:

⭐ Option A – Direkt in HACS öffnen

Klicke auf den Button und HACS öffnet sich automatisch mit dem vorausgefüllten Repository:

🏠 In HACS öffnen

Empfohlen – funktioniert nur wenn my.home-assistant.io in deiner HA-Instanz konfiguriert ist.

🔗 Option B – Repository URL manuell

Öffne HACS, klicke auf ⋮ → „Benutzerdefiniertes Repository" und füge diese URL ein:

Repository URL

https://github.com/Maximilian-Andrew-Kluge/VpMobile24

Kategorie: Integration → Hinzufügen klicken.

2

Integration installieren & HA neu starten

Suche in HACS nach VpMobile24, klicke auf Installieren und starte Home Assistant anschließend neu.

💡 Nach dem Neustart erscheint die Integration automatisch in der Integrationsliste.

3

Integration einrichten

Gehe zu Einstellungen → Geräte & Dienste → Integration hinzufügen und suche nach VpMobile24.

Schul-ID Die ID deiner Schule (z.B. 10001329)

Benutzername Dein VpMobile24-Benutzername

Passwort Dein VpMobile24-Passwort

Klasse Klassenname, z.B. 10b

1

Integration herunterladen

Wähle eine der folgenden Methoden:

Option A – Git Clone

Klone das komplette Repository mit Git:

Terminal

git clone https://github.com/Maximilian-Andrew-Kluge/VpMobile24.git

Danach liegt der Ordner VpMobile24/custom_components/vpmobile24/ lokal vor.

Option B – ZIP herunterladen

Lade nur den custom_components-Ordner als ZIP herunter — immer die neueste Version:

⬇️ custom_components herunterladen

ZIP enthält den kompletten Repo-Stand. Entpacke und kopiere nur den Ordner custom_components/vpmobile24/.

2

Dateien kopieren

Kopiere den Ordner custom_components/vpmobile24/ in dein Home Assistant Konfigurationsverzeichnis:

Zielpfad

/config/custom_components/vpmobile24/

3

Home Assistant neu starten & einrichten

Starte Home Assistant neu. Gehe dann zu Einstellungen → Geräte & Dienste und füge die VpMobile24 Integration hinzu.

Lovelace Card

Die Stundenplan Card einrichten

Die Card wird automatisch mit der Integration installiert. Du musst nur noch die Ressource registrieren.

1

Ressource in Home Assistant hinzufügen

Gehe zu Einstellungen → Dashboards, klicke oben rechts auf ⋮ und wähle Ressourcen.

Klicke auf + Ressource hinzufügen und trage folgendes ein:

URL

/local/vpmobile24/vpmobile24-card.js

Ressourcentyp JavaScript-Modul

💡 Die Card-Datei wird beim Start von Home Assistant automatisch nach /config/www/vpmobile24/ kopiert. Du musst nichts manuell kopieren!

2

Card zum Dashboard hinzufügen

Öffne dein Dashboard, klicke auf Bearbeiten → + Karte hinzufügen und suche nach VpMobile24 Card.

Alternativ kannst du die Card direkt per YAML hinzufügen:

Vollständige YAML-Konfiguration

type: custom:vpmobile24-card
entity: sensor.vpmobile24_week_table
additional_info_entity: sensor.vpmobile24_zusatzinfos
reload_entity: button.vpmobile24_reload
show_header: true
header_settings:
  title: Stundenplan
  class_name: 10b
highlight_today: true
show_time: true
use_custom_times: false

3

Card konfigurieren

Die Card bietet eine vollständige visuelle Konfiguration – kein YAML nötig. Alle Optionen im Überblick:

OptionBeschreibungStandard

entityWeek Table Sensorsensor.vpmobile24_week_table

show_headerHeader anzeigentrue

highlight_todayHeutigen Tag hervorhebentrue

show_timeUhrzeiten anzeigentrue

use_custom_timesEigene Uhrzeiten verwendenfalse

additional_info_entityZusatzinfo-Sensor (ⓘ-Button)—

reload_entityNeu-laden Button Entity—

Sensoren

Erstellte Sensoren

Nach der Einrichtung stehen dir folgende Sensoren in Home Assistant zur Verfügung:

📅

sensor.vpmobile24_week_table

Vollständige Wochenübersicht – wird von der Lovelace Card verwendet

🕐

sensor.vpmobile24_naechste_stunde

Nächste Unterrichtsstunde heute

📆

sensor.vpmobile24_wochenstundenplan

Heutiger Stundenplan mit allen Stunden

ℹ️

sensor.vpmobile24_zusatzinfos

Zusatzinformationen und Hinweise pro Tag

🔄

sensor.vpmobile24_aenderungen

Aktuelle Vertretungen und Stundenplanänderungen

📅

calendar.vpmobile24_week_calendar

Wochenkalender – nutzbar in HA-Kalender-Ansicht

🔁

button.vpmobile24_reload

Manuelles Neuladen der Stundenplandaten

💡 Bei mehreren Klassen werden die Sensor-IDs mit der Klasse ergänzt, z.B. sensor.vpmobile24_week_table_10b. Die genauen IDs findest du unter Einstellungen → Geräte & Dienste → VpMobile24.

Hilfe

Troubleshooting

Etwas funktioniert nicht? Hier sind die häufigsten Probleme und ihre Lösungen.

Card wird nicht angezeigt

Überprüfe, ob die VpMobile24 Integration installiert ist
Überprüfe, ob die Ressource korrekt hinzugefügt wurde (/local/vpmobile24/vpmobile24-card.js)
Leere den Browser-Cache mit Strg + F5
Starte Home Assistant neu

Entity nicht gefunden / Sensor fehlt

Stelle sicher, dass die VpMobile24 Integration korrekt installiert ist und der Sensor sensor.vpmobile24_week_table existiert. Gehe zu Einstellungen → Geräte & Dienste und prüfe den Status der Integration.

404-Fehler bei der Ressource

Stelle sicher, dass die Integration installiert und geladen ist
Starte Home Assistant neu – die Card wird beim Start automatisch kopiert
Prüfe die Logs unter Einstellungen → System → Protokolle

Stundenplan wird nicht aktualisiert

Die Integration ruft Daten alle 15 Minuten ab. Prüfe deine Zugangsdaten und stelle sicher, dass deine Schule VpMobile24 / Stundenplan24 verwendet. Bei anhaltenden Problemen erstelle ein Issue auf GitHub.

Pausen-Zeiten werden nicht übernommen

Wenn du eigene Pausenzeiten verwenden möchtest, musst du nach dem Aktivieren von „Eigene Uhrzeiten verwenden" die gewünschten Zeiten im aufklappbaren Bereich „Uhrzeiten-Anpassung" eintragen.

Aktiviere die Option „Eigene Uhrzeiten verwenden" in der Card-Konfiguration
Klappe den Abschnitt „Uhrzeiten-Anpassung" auf – er erscheint direkt darunter
Trage dort deine gewünschten Pausen-Zeiten ein und speichere die Konfiguration

💡 Die Zeiten werden erst übernommen, wenn sie im aufgeklappten Bereich eingetragen und gespeichert wurden.

Mehrere Klassen mit gleichen Zugangsdaten einrichten

Ab v2.5.0 kannst du mehrere Klassen derselben Schule mit identischen Zugangsdaten einrichten:

Gehe zu Einstellungen → Geräte & Dienste → Integration hinzufügen
Wähle erneut VpMobile24 und gib dieselben Zugangsdaten ein
Trage eine andere Klasse ein (z.B. 10b statt 10a)
Jede Klasse bekommt ein eigenes Gerät: VpMobile24 – 10a (12345) und VpMobile24 – 10b (12345)

💡 Gleiche Schule + gleiche Klasse wird automatisch verhindert – du bekommst eine Fehlermeldung wenn du versuchst eine bereits konfigurierte Kombination erneut anzulegen.

ⓘ-Button wird nicht angezeigt

Der ⓘ-Button erscheint nur wenn additional_info_entity in der Card-Konfiguration gesetzt ist:

YAML

                  additional_info_entity: sensor.vpmobile24_zusatzinfos

Kostenlos & Open Source

Bereit loszulegen?

Installiere VpMobile24 jetzt und hab deinen Stundenplan immer im Blick – in weniger als 5 Minuten eingerichtet.

🏠 Via HACS installieren GitHub Repository 💬 Discord Community

🟢 Stable: v2.5.0