Webcamloader (Debian / 07.2025)

Der Webcamloader ist ein Kamera-Bildloader, der universell eingesetzt werden kann.

Der Sinn dahinter ist, dass Bilder von einer Kamera gezogen werden und mit diesen dann am Ende ein Video daraus zu machen.

Das Programm verwendet - wie überall von mir eingesetzt - den Auslagerungsordner /home/$USER/script-data. Darin wird dann webcamloader erstellt und Programm-, Log- & Statusdaten abgelegt. Sofern kein eigenes Verzeichnis für die Medien (Bilder/Videos) angegeben wurde, wird in dem Data-Ordner nochmals webcamloader angelegt. Es ist sinnvoll, den webcamloader aufgrund der Datei- / Projektgrößen auf externe Datenträger auszulagern. Der Pfad ist zu Beginn bei der Installation oder später in der Konfiguration zu ändern.

Genauer: Dieses Bash-Script lädt automatisch Einzelbilder von einer Bildquelle oder Videostream herunter, speichert sie lokal ab. Bei Fehlern oder Fertigstellung eines Projektes kann optional eine Email gesendet werden. Der Sinn dahiner ist ein Zeitraffer-Video zu erhalten, Baufortschrittsdokumentationen oder auch Wetterkameras, usw.

Unterstützte Kameraformate: Bildquellen (z. B. jpg, snapshot.cgi) oder Videostreams (z. B. faststream, motion-jpeg, video.cgi).

Wenn das Script zum ersten Mal ausgeführt wird, werden Pfadangaben abgefragt, danach werden allgemeine Dinge aus der Konfiguration abgefragt.

Es gibt ein Menü bei blanko-Ausführung (./webcamloader.sh), einen Quicky-Modus mit kompletter Argumentenübergabe (./webcamloader quicky ...) und einen cron-Modus für die Crontab, um z. B. einmal täglich ein Bild anzufertigen (./webcamloader.sh cron ...).

Funktion im Wesentlichen erklärt:
Das Script prüft zu Beginn, ob die Kamera erreichbar ist, lädt ein Testbild, errechnet anhand diesem die erforderliche Größe für die Bildanzahl, erstellt im nächsten Schritt Projektordner und beginnt die Arbeit.
Falls ein Zeitfenster angegeben wurde, wird dieses berücksichtigt.
Im Fehlerfall wird der Benutzer benachrichtigt per Email, sofern angegeben.

Allgemeine Hinweise:
• Die Kamera-URL muss direkt zum Bild/Video führen, bitte nicht zur Eingabemaske oder die Kamera selbst!
• Falls Email angegeben wird, muss der Server per "mail" (sendmail) in der Lage sein, Emails versenden können!
• Bei dem Funktionsschalter ist zu beachten: -f 0 ist Hintergrundmodus (keine Ausgabe), -f 1 ist Vordergrundmodus, komplette Ausgabe. Falls Ausgabe erwünscht ist, wird das Programm screen empfohlen, da bekanntlich beim Schließen des Terminals auch die Arbeit des Webcamloaders unterbrochen wird!
• Wird keine Funktion -f angegeben, startet automatisch der Vordergrundmodus.

=== FUNKTIONSHINWEISE Quicky-Modus ===

Der Quicky-Modus ist gedacht für schnelles Beginnen eines Projekts. Nach Übergabe aller erforderlichen Parameter erhält man eine Zusammenfassung mit Berechnung der Aufnahmedauer und kann mit ENTER das Projekt beginnen.

Aufruf: ./webcamloader.sh quicky -u <URL> -n <Name> -b <Anzahl> -i <Intervall> -e <E-Mail> -f <Funktion 0|1> -t <Zeitfenster>

Parameter im Einzelnen:
-u = Kamera URL komplett mit http(s).
-n = Projektname. Freier Name für das Projekt.
-b = Bilderanzahl für das Gesamtprojekt.
-i = Intervall für die Pausenzeiten zwischen den Bilderdownloads.
-e = Email (optional) für die Benachrichtigung (optional).
-f = Funktion/Ausführung - 0 oder 1 (optional).
-t = Zeitfenster im Format 9-18 (optional).

=== FUNKTIONSHINWEISE Cron-Modus ===

Der Cron-Modus ist ein Einmalaufruf, bei dem genau ein Bild gespeichert wird. Dieser ist gedacht für Langzeitaufnahmen mit Bild einmal am Tag per Crontab. Dabei können auch Folgebilder gesetzt werden. Dies ist sinnvoll, wenn der Cron-Befehl um 12:00 Uhr losgeht aber man nochmal ein Bild um 16:00 Uhr haben möchte. Klar könnte man den Crontab als 12,16 kennzeichnen - man könnte hier auch 2 Bilder definieren im Abstand von 4 Stunden. Ist Geschmackssache.

Aufruf: ./webcamloader.sh cron -u <URL> -n <Name> -x <Anzahl> -y <Intervall>

Parameter im Einzelnen:
-u = Kamera URL komplett mit http(s).
-n = Projektname. Freier Name für das Projekt.
-x = Folgebilder (optional).
-y = Intervall (optional).

Die herunterladenen Bilder werden unter dem Medien-Pfad, wie eingangs definiert, angesehen werden. Videos ebenfalls, sofern sie übers Menü des Scripts generiert wurden.

Das Programm kann man hier in immer der neuesten Version herunterladen und sich zunutze machen:

Webcamloader Script

Vielen Dank, 
mariobeh.