Fangreport

Beschreibung

Viele Angler denken darüber nach, Fangbuch zu führen. Die meisten geben das Vorhaben aber schnell wieder auf, weil das manuelle Zusammentragen von Umweltbedingungen eine mühsame Aufgabe ist. Hier setzt Fangreport an. Es erstellt nach Eingabe weniger Eckdaten vollautomatisch Fangreports mit reichen Details zu Umweltbedingungen. So werden u. a. Temperatur, Luftdruck, Regen, Windgeschwindigkeit, Mondphase und Pegelstände erfasst und in leicht verständlicher Weise dargestellt. So kann man erst verlässlich feststellen, ob die Zielfische ein erkennbares Fressmuster haben. Aber auch, wenn es um das Festhalten von Erinnerungen geht, hilft Fangreport einfach und schnell.

Setup

Voraussetzungen

Installieren Sie git und Python auf dem Computer.

Einrichten des Repositorys

Klonen Sie das Repository in einen lokalen Ordner, indem sie diesen im Terminal öffnen und folgenden Befehl eingeben:

https://github.com/martinhanik/Fangreport.git

Gehen Sie nun in den Wurzelordner des Repositorys. Wurde dieses unter dem Standard-Ordnernamen angelegt, lautet der Befehl:

cd Fangbuch

Die folgenden Befehle setzen voraus, dass wir uns im Wurzelordner befinden

Sie können nun eine virtuelle Umgebung mit dem Befehl

python -m venv .venv

anlegen.

Aktivieren Sie die Umgebung bei jeder Nutzung durch den Befehl

source .venv/bin/activate

Die benötigten Pakete werden durch folgenden Befehl installiert:

pip install -r requirements.txt

Nutzung

Erstellen eines Fangreports

Die Erstellung eines Reports ist mithilfe einer GUI möglich. Sie lässt sich mit dem Befehl

python -m fangreport.gui

starten. Die GUI erlaubt es, alle relevanten Angaben zu einem Fang zu erfassen. Notwendige Angaben sind mit einem Stern (*) markiert.

Auch über die Konsole lässt sich ein Fangreport erstellen. Der Befehl lautet:

#  Das Datum muss innerhalb der letzten 30 Tage liegen.
python -m fangreport.client --Fischart Wels --Länge 130 --Gewicht 13 --Datum 2026-05-22 --Zeit 20:00 --Breitengrad 49.357599616156776 --Längengrad 8.494281048199765 --Pegelstation Speyer --Wassertemperatur 12.5 --Trübung klar 

Hier wurde am 22.5.2026 um 20 Uhr ein Wels von 130 cm und 13 kg gefangen. Die Koordinaten des Fangorts (am Rhein) sind (49.357599616156776, 8.494281048199765). Die Messstation, von der der Pegel abgefragt werden soll, ist Speyer. Zum Zeitpunkt des Fangs war das Wasser klar und hatte eine Temperatur von 12,5 Grad Celsius. Der Ordnerpfad zu einem Fangfoto könnte noch mit dem Argument --Fotopfad angegeben werden.

Die Argumente --Länge, --Wassertemperatur, --Trübung und --Fotopfad sind optionale Parameter. Ein fertiger Fangreport wird im Ordner Fänge gespeichert.

Unterstützte Pegelstellen

Fangreporte können für deutsche Pegelstationen bis zu 30 Tage rückwirkend erstellt werden. Eine Liste aller Pegelstellen findet sich auf der Pegelonline-Webseite.

Zusätzlich unterstützt Fangreport erste Pegelstationen in Italien:

am Po

• Piacenza,
• Cremona,
• Casalmaggiore,
• Boretto,
• Borgoforte,
• Sermide e Felonica/Castelmassa,
• Pontelagoscuro,
• Polesella,
• Cavanella;

am Mincio

• Peschiera del Garda,
• Monzambano,
• Goito,
• Lago Superiore,
• Lago di Mezzo,
• Vallazza,
• Governolo;

und am Oglio

• Marcaria.

Italienische Stationen erlauben es teilweise, einen Report von einem Fang zu erstellen, der mehr als 30 Tage zurückliegt.

Für italienische Stationen versucht Fangreport, Pegeldaten automatisch über die jeweilige regionale Datenquelle abzurufen. Dabei werden die Daten aller kursiv geschriebenen Stationen über das Portal der Agenzia Interregionale per il fiume Po (AIPO) geladen. Hierfür braucht es einen gültigen Refresh-Token und eine gültige Client-ID. Diese müssen bei der ersten Nutzung oder wenn längere Zeit kein Fangreport erstellt wurde aus einem Browser geladen werden. Man findet sie nach dem Öffnen der Seite unter dem Reiter „Webinformationen“ des Entwicklertools im lokalen Speicher. Anschließend müssen die Daten in der JSON-Datei aipo_auth.json in fangreport/data gespeichert werden. Als Vorlage dient aipo_auth_example.json, das im selben Ordner liegt.

Alle fett geschriebenen Stationen werden aus der Datenbank der Agenzia Regionale per la Protezione dell'Ambiente (ARPA) Lombardia abgerufen. Hierfür sind keine weiteren Daten erforderlich.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Weitere Informationen finden Sie in der Datei LICENSE.