Alles was du brauchst
VpMobile24 bringt deinen Stundenplan direkt in Home Assistant – mit einem modernen Navy-Design und praktischen Funktionen.
Klick-Details
Klicke auf jede Fach-Kachel um ein Popup mit Lehrer, Raum, Uhrzeit und Zusatzinfo zu sehen.
Zusatzinfos
Der ⓘ-Button neben dem heutigen Tag zeigt alle allgemeinen Zusatzinformationen des aktuellen Tages – pulsiert wenn Infos vorhanden.
Mobiler Modus
Auf dem Handy: kompakte Einzelspalten-Ansicht mit Tag-Tabs (Mo–Fr). Heute wird automatisch vorausgewählt.
Auto-Update
Die Card-Datei wird bei jedem HA-Start automatisch aktualisiert. Cache-Busting sorgt dafür dass Browser immer die neueste Version laden.
Navy Design
Festes dunkles Navy-Design – unabhängig vom HA-Theme. Heute-Spalte blau, Vertretungen dunkelrot, abgerundete Kacheln.
Eigene Uhrzeiten
Passen deine Schulzeiten nicht zu den Defaults? Trage eigene Stunden- und Pausenzeiten direkt in der visuellen Konfiguration ein.
In 3 Schritten startklar
Wähle deine bevorzugte Installationsmethode. HACS ist der empfohlene Weg.
HACS öffnen & Repository hinzufügen
Wähle eine der folgenden Methoden um VpMobile24 in HACS hinzuzufügen:
Klicke auf den Button und HACS öffnet sich automatisch mit dem vorausgefüllten Repository:
🏠 In HACS öffnenEmpfohlen – funktioniert nur wenn my.home-assistant.io in deiner HA-Instanz konfiguriert ist.
Öffne HACS, klicke auf ⋮ → „Benutzerdefiniertes Repository" und füge diese URL ein:
https://github.com/Maximilian-Andrew-Kluge/VpMobile24
Kategorie: Integration → Hinzufügen klicken.
Integration installieren & HA neu starten
Suche in HACS nach VpMobile24, klicke auf Installieren und starte Home Assistant anschließend neu.
Integration einrichten
Gehe zu Einstellungen → Geräte & Dienste → Integration hinzufügen und suche nach VpMobile24.
10001329)
10b
Integration herunterladen
Wähle eine der folgenden Methoden:
Klone das komplette Repository mit Git:
git clone https://github.com/Maximilian-Andrew-Kluge/VpMobile24.git
Danach liegt der Ordner VpMobile24/custom_components/vpmobile24/ lokal vor.
Lade nur den custom_components-Ordner als ZIP herunter — immer die neueste Version:
ZIP enthält den kompletten Repo-Stand. Entpacke und kopiere nur den Ordner custom_components/vpmobile24/.
Dateien kopieren
Kopiere den Ordner custom_components/vpmobile24/ in dein Home Assistant Konfigurationsverzeichnis:
/config/custom_components/vpmobile24/
Home Assistant neu starten & einrichten
Starte Home Assistant neu. Gehe dann zu Einstellungen → Geräte & Dienste und füge die VpMobile24 Integration hinzu.
Die Stundenplan Card einrichten
Die Card wird automatisch mit der Integration installiert. Du musst nur noch die Ressource registrieren.
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:
/local/vpmobile24/vpmobile24-card.js
/config/www/vpmobile24/ kopiert. Du musst nichts manuell kopieren!
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:
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: falseCard konfigurieren
Die Card bietet eine vollständige visuelle Konfiguration – kein YAML nötig. Alle Optionen im Überblick:
Erstellte Sensoren
Nach der Einrichtung stehen dir folgende Sensoren in Home Assistant zur Verfügung:
sensor.vpmobile24_week_tablesensor.vpmobile24_mondaysensor.vpmobile24_tuesdaysensor.vpmobile24_wednesdaysensor.vpmobile24_thursdaysensor.vpmobile24_fridayTroubleshooting
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
Änderungen werden nicht übernommen
- Leere den Browser-Cache mit Strg + F5
- Öffne die Browser-Konsole (F12) und prüfe auf Fehler
- Stelle sicher, dass die neueste Version geladen wurde
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
ⓘ-Button wird nicht angezeigt
Der ⓘ-Button erscheint nur wenn additional_info_entity in der Card-Konfiguration gesetzt ist:
additional_info_entity: sensor.vpmobile24_zusatzinfos
Bereit loszulegen?
Installiere VpMobile24 jetzt und hab deinen Stundenplan immer im Blick.