Skip to content

Proof-of-concept to import timetables from PDF (or even paper) and provide their content as iCal subscription.

License

Notifications You must be signed in to change notification settings

rzfuhrmann/szrof-hhfr-stundenplan-ical

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Allgemeines


HINWEIS
Dieses Projekt steht in keinerlei Verbindung mit dem Studienzentrum Rotenburg an der Fulda.


Dieses Repository enthält im Wesentlichen zwei Skripte zum Importieren und Verarbeiten der vom Studienzentrum Rothenburg (Fulda) zur Verfügung gestellten PDF-Stundenpläne.

  • importPlan.php ruft pdf2htmlEX auf, um einen PDF-Stundenplan in HTML zu konvertieren und im Anschluss zu verarbeiten. Bei der Verarbeitung werden Wochentage, Gruppen, Stunden (und ihr Beginn und Ende), einzelne Vorlesungen und Dozentenkürzel erkannt, aufbereitet und in einer Datenbank gespeichert.
  • index.php ruft die dadurch gewonnen Daten (zusammen mit einigen META-Informationen wie Verpflegungsplan und Standard-Räume) aus einer Datenbank ab und erzeugt daraus ein iCal-File, welches von Microsoft Outlook, Google Calendar oder Apple Calender abonniert werden kann.

Kontakt

Ich bin immer an Anregungen, konstruktiver Kritik und neuen Umsetzungsideen interessiert! Auch bei Fragen oder Problemen stehe ich gerne zur Verfügung.

E-Mail: [email protected]

Ziel

Ziel ist es, Anwärtern des aktuellen 2020er-Jahrgangs möglichst schnell und komfortabel den Stundenplan, welcher bisher nur auf Papier oder als PDF verteilt wird, auf ihren Smartphones und PCs zur Verfügung zu stellen. Es ist sicherlich eine temporäre Lösung, die aber schnell umsetzbar war.

Aktuelles Setup

Datenbank und iCal-Dienst werden zurzeit auf Server im Internet betrieben. Der iCal-Kalender kann von jedem frei verfügbar abonniert werden - die Daten (Dozenten sowie Räume) werden hier allerdings anonymisiert. Nur für authentifizierte Nutzer (bitte anfragen) steht eine vollständige, nicht-anonymisierte Version zur Verfügung.

Der Import der Stundenplan-PDFs erfolgt aktuell über interne Server der Familie Fuhrmann/des Rechenzentrum Fuhrmann. Per Cronjob wird regelmäßig geprüft, ob neue PDF-Stundenpläne zur Verfügung stehen - falls ja startet importPlan.php.

iCal-Kalender abonnieren


Disclaimer: Bitte nur eingeschränkt auf diese Daten verlassen
Da es sich hierbei um kein offizielles Projekt des Studienzentrums handelt - wofür ich aber natürlich jederzeit zur Verfügung stehe ;) -, ist nicht gewährleistet, dass die Daten alle, vollständig und korrekt importiert werden; dies bitte im Hinterkopf behalten. Im Zweifelsfall gilt immer der Stundenplan des Studienzentrums - auch, wenn der auf Papier kommt.


Der iCal-Dienst steht zurzeit unter folgender URL zur Verfügung:

https://ical.simonefuhrmann.de/?gruppe=1.11

Dabei sollte 1.11 unbedingt durch die eigene Gruppenbezeichnung ersetzt werden. Wird anstelle einer Gruppenbezeichnung all eingesetzt, werden die Stundenpläne aller Gruppen abonniert.

iOS-Geräte

  • Geräte-Einstellungen öffnen
  • Passwort & Accounts
  • Add Account / Account hinzufügen
  • Other / Anderer Account
  • Add Subcribed Calender / Kalenderabo hinzufügen
  • Bei Server obige URL eingeben
  • Name beliebig setzen
  • Abspeichern - fertig. :)

Video: iOS-Einstellungen
Alt Text

Android-Geräte

Für Android-Geräte gibt es leider keine einheitliche und schnelle Lösung. Die beiden Optionen hier beschreiben Möglichkeiten, mit denen der iCal-Kalender abonniert und dem zentralen Geräte-Kalender hinzugefügt werden kann.

Bitte beachten, dass es zahlreiche andere Apps geben kann, die iCal-Abonnements unterstützen und auch gut funktionieren (Vorschläge gern an [email protected]). Bei der Wahl einer App sollte auf folgendes geachtet werden:

  • die oben angegebene URL muss abonniert und nicht nur einmalig heruntergeladen werden
  • ein angemessener Aktualisierungsintervall ist etwa eine Stunde

Android: Google Kalender


Achtung: Aktualisierungsintervall!
Google Kalender aktualisiert die abonnierten/importierten Kalender leider nur alle 24 Stunden - oder noch seltener. Das reicht gerade noch aus, doch werden kurzfristige Änderungen möglicherweise nicht rechtzeitig angezeigt.


Der Vorteil beim Abonnieren des iCal-Kalenders über Google Kalender besteht darin, dass der Kalender automatisch auf alle Android-Geräte synchronisiert wird, die diesen Google-Account verwenden.

  • calendar.google.com im Browser öffnen
  • Links bei "Weitere Kalender" auf das "+"
  • Klick auf "Per URL"
  • URL (siehe oben) eingeben
  • Haken bei "Kalender öffentlich machen" entfernen falls gesetzt
  • Klick auf "Kalender hinzufügen"
  • Der Kalender sollte dann mit der URL in der Kalenderliste links angezeigt werden. Diesen Dort auswählen und einen sinnvollen Namen (z.B. "HHFR Gruppe 1.x") vergeben.
  • Der Kalender sollte dann auch auf dem Smartphone angezeigt werden.

Android: App ICSx⁵ – Webcal & .ics-Kalender-Sync

Über die App ICSx⁵ – Webcal & .ics-Kalender-Sync (kostet einen Obulus im Play Store, gibt es aber auch bei F-Droid) lassen sich iCal-Kalender sehr komfortabel auf dem Android-Smartphone abonnieren und direkt in den Geräte-Kalender importieren, sodass sie auch von anderen Apps genutzt werden können. Auch der Aktualisierungsintervall lässt sich beliebig einstellen.

Microsoft Outlook

  • Kalender öffnen
  • "Aus dem Internet..." > URL eingeben > OK
  • "Erweitert" > Sinnvollen Namen geben
  • "OK" > "Ja"
  • Fertig :)

Kalender aus dem Internet öffnen: URL eingeben
Klick auf "Erweitert"
Sinnvollen Namen vergeben
Stundenplan von Gruppe 1.11 in Outlook

About

Proof-of-concept to import timetables from PDF (or even paper) and provide their content as iCal subscription.

Topics

Resources

License

Stars

Watchers

Forks

Languages