Anleitung

Zum Ausführen dieses Programms empfiehlt sich ein Linux-System (z.B. Debian oder Ubuntu).

Die unten angegebenen Befehle sollen im Terminal ausgeführt werden.

Vorbereitung

1. Die Programme python3, sox und git müssen installiert sein. Dazu eignet sich z.B. der folgende Befehl:

   sudo apt install python3 sox git
   

2. Herunterladen (falls noch nicht geschehen) mit folgenden Befehlen:

   git clone https://git.fwg-cag.de/int/monitor/vertretungsplan.git
   cd vertretungsplan/
   

3. Einrichten des Zugangsschlüssels: (123456789012345678 durch den Schlüssel ersetzen)

   echo 123456789012345678 > ~/.config/vertretung.token
   

Nutzung

Laden der Daten von Untis

python3 untis.py > vertretungsplan.json

Anzeigen der Daten

Variante 1: 4-Tage-Anzeige:

python3 monitor.py --data vertretungsplan.json

Variante 2: Monitor-Anzeige: Die Zahl 0 steht für den heutigen Tag, kann aber auf eine positive Zahl für einen zukünftigen Tag geändert werden. Wenn heute kein Schultag ist, steht die Zahl 0 für den nächsten Schultag.

python3 monitor.py --data vertretungsplan.json --start-day 0 --screen ${COLUMNS}x${LINES}

Die Anzeige kann mit Ctrl-C beendet werden. Leider ist das Terminal danach unbrauchbar und muss mit dem Befehl "reset" zurückgesetzt werden.

Variante 3: Vertretungsplan zum Anhören: Die Zahl 1 steht für den nächsten Schultag, kann aber auch wie bei der Monitor-Anzeige beliebig geändert werden. Wenn heute kein Schultag ist, steht die Zahl 1 für den übernächsten Schultag!

sox $(python3 audio.py vertretungsplan.json 1) PLAN.mp3
play PLAN.mp3

Damit die Datei PLAN.mp3 erzeugt wird, muss mindestens ein Sample vorhanden sein. Das Programm gibt eine liste fehlender Sample-Dateien aus. Diese können im Vertretungsplan-Ordner hinterlegt werden, in dem sich das Python-Skript monitor.py befindet. Danach ist der Befehl erneut auszuführen.

Lehrerkürzel und Raumnummern werden beim Vorlesen buchstabiert, wenn sie keine eigenen Samples haben. Für jedes Kürzel XXX kan eine Sample-Datei XXX.mp3 hinzugefügt werden, z.B. Beh.mp3 oder AULA.mp3, in welcher der vollständige Lehrer- oder Raumname vorgelesen wird.