bmbfTNL -- Automatisches Erstellen von Teilnehmendenlisten für das BMBF

bmbfTNL ist eine Pythonanwendung für die Kommandozeile um automatisch Teilnehmendenlisten für Veranstaltungen, welche durch das BMBF geförtdert werden auszufüllen. bmbftnl ist kein offizielles Tool des BMBF und wurde nicht in Kooperation mit diesem entwickelt. Verwendung auf eigene Verantwortung!

Installation

bmbftnl kann einfach mittels pip oder pipx installiert werden. Letzteres bietet sich für die einfache Verwendung auf der Kommandozeile an. Das Programm wurde lediglich unter Linux getestet, sollte allerdings auch unter Windows und MacOS funktionieren.

pip install bmbftnl
# oder
pipx install bmbftnl

Nutzung

Zum einfachen Erstellen der Teilnehmendenlisten wird das Programm bmbftnl auf der Kommandozeile aufgerufen. Die verpflichtenden und optionalen Argumente sind unten aufgeführt. Die Teilnehmendenliste kann beliebig viele Spalten haben wobei die Spalten name, standort und eingeschrieben präsent sein müssen -- ein Beispiel findest du weiter unten.

[!IMPORTANT] Es werden 1024 Byte (~Zeichen) eingelesen um das CSV-Format zu bestimmen. Dies mag unter Umständen bei sehr(!) großen Tabellen nicht ausreichend sein um die Kopfzeile einzulsesen.

[!NOTE] Das Programm wurde mit Vorlagen aus dem Jahr 2018/2019 und 2024/2025 getestet. Einige sehr lange Standortnamen (> 65 Zeichen) können unter Umständen in der Liste abgeschnitten werden, hier kann es sich lohnen mit der Option --kleiner-font zu arbeiten.

usage: bmbftnl [-h] --titel TITEL --organisation ORGANISATION --beginn BEGINN --ende ENDE --teilnehmende TEILNEHMENDE --vorlage VORLAGE [--extra-seiten EXTRA_SEITEN] [--kleiner-font] out_dir

Automatisches Ausfüllen von Teilnehmendenlisten des BMBF mit Namen, Standort und Studierendenstatus

positional arguments:
  out_dir               Pfad zu Verzeichnis, in welchem Dateien abgespeichert werden sollen (aktuelles Verzeichnis mit Punkt angeben)

options:
  -h, --help            show this help message and exit
  --titel TITEL         Titel der Veranstaltung
  --organisation ORGANISATION
                        Ausrichtende Organisation
  --beginn BEGINN       Beginn der Veranstaltung im ISO-Format (yyyy-mm-dd)
  --ende ENDE           Ende der Veranstaltung im ISO-Format (yyyy-mm-dd)
  --teilnehmende TEILNEHMENDE
                        CSV-Tabelle mit den Spalten name, standort und eingeschrieben. Letzteres durch ja/nein angegeben
  --vorlage VORLAGE     Dateipfad zu der vom BMBF erstellten Vorlage. Zuletzt getestest mit Vorlage 2024/2025
  --extra-seiten EXTRA_SEITEN
                        Anzahl an Leerseiten pro Tag, die hinzugefügt werden
  --kleiner-font        Nutze standardmäßig originale Fontgröße (groß) für den Standort; wenn angegeben, nutze kleine Fontgröße. Sinnvoll für lange Standortnamen

name,standort,eingeschrieben
Max Mustermann,Universität zu Musterstadt,ja
Marie Musterfrau,Andere Universität,ja
Jonathan Musterperson,Universität Musterstadt,nein

Lizenz

bmbftnl ist unter der MIT Lizenz lizensiert.

Danksagung

Die Idee für bmbftnl kommt von Jörn Tillmanns, dessen Version du hier findest. bmbftnl vereinfacht die Anwendung durch die Bereitstellung eines Kommandozeilenprogramms sowie der Entfernung von externen Programmen.