webscreenshot

Beschreibung

Ein einfaches Skript, um eine Liste von Webseiten zu screenshoten, basierend auf dem url-to-image PhantomJS-Skript.

Funktionen

• Integration von url-to-image 'lazy-rendering' für AJAX-Ressourcen
• Voll funktionsfähig auf Windows- und Linux-Systemen
• Cookie- und benutzerdefinierte HTTP-Header-Definitionsunterstützung für den PhantomJS-Renderer
• Multiprocessing und Beenden von nicht reagierenden Prozessen nach einem benutzerdefinierten Timeout
• Akzeptiert mehrere Formate als Eingabeziele
• Anpassen der Screenshot-Größe (Breite, Höhe), des Formats und der Qualität
• Abbildung nützlicher Optionen von PhantomJS wie Ignorieren von SSL-Fehlern, Proxy-Definition und Proxy-Authentifizierung, HTTP Basic Authentication
• Unterstützt mehrere Renderer:
  • PhantomJS, das veraltet und aufgegeben ist, aber immer noch die besten Ergebnisse liefert.
  • Chromium, Chrome und Edge Chromium, die PhantomJS ersetzen werden, aber derzeit einige Einschränkungen haben: Das Screenshot einer HTTPS-Website ohne gültiges Zertifikat, z. B. eines selbstsignierten, erzeugt einen leeren Screenshot. Der Grund ist, dass die --ignore-certificate-errors Option nicht funktioniert und nie wieder funktionieren wird: Die Lösung ist die Verwendung eines ordentlichen Webdrivers, aber bis heute unterstützt webscreenshot diese ziemlich komplexe Methode mit Tools von Drittanbietern nicht.
  • Firefox kann ebenfalls als Renderer verwendet werden, hat aber einige schwerwiegende Einschränkungen (deshalb derzeit nicht verwenden):
    • Unmöglichkeit, mehrere Screenshots gleichzeitig zu erstellen: keine Multi-Instanz des Firefox-Prozesses
    • Kein Inkognito-Modus, die Verwendung von webscreenshot wird Ihren Browserverlauf verunreinigen
• Einbetten der Screenshot-URL in das Bild (erfordert ImageMagick)

Verwendung

Geben Sie Ihre Ziele in eine Textdatei und übergeben Sie sie mit der Option -i, oder als Positionsargument, wenn Sie nur eine einzelne URL haben. Screenshots werden standardmäßig in Ihrem aktuellen ./screenshots/-Verzeichnis abgelegt. Akzeptierte Eingabeformate sind die folgenden:

http(s)://domain_or_ip:port(/resource)
domain_or_ip:port(/resource)
domain_or_ip(/resource)

Optionen

webscreenshot.py version 2.96

usage: webscreenshot [-h] [-i INPUT_FILE] [-o OUTPUT_DIRECTORY] [-w WORKERS] [-v] [--no-error-file] [-z SINGLE_OUTPUT_FILE] [-p PORT]
                     [-s] [-m] [-r {phantomjs,chrome,chromium,edge,firefox}] [--renderer-binary RENDERER_BINARY] [--no-xserver]
                     [--window-size WINDOW_SIZE] [-f {pdf,png,jpg,jpeg,bmp,ppm}] [-q [0-100]] [--ajax-max-timeouts AJAX_MAX_TIMEOUTS]
                     [--crop CROP] [--custom-js CUSTOM_JS] [-l] [--label-size LABEL_SIZE] [--label-bg-color LABEL_BG_COLOR]
                     [--imagemagick-binary IMAGEMAGICK_BINARY] [-c COOKIE] [-a HEADER] [-u HTTP_USERNAME] [-b HTTP_PASSWORD]
                     [-P PROXY] [-A PROXY_AUTH] [-T PROXY_TYPE] [-t TIMEOUT]
                     [URL]

options:
  -h, --help            show this help message and exit

Hauptparameter:
  URL                   Einzelnes URL-Ziel als Positionsargument
  -i, --input-file INPUT_FILE
                        <INPUT_FILE> Textdatei, die die Zielliste enthält. Bsp.: list.txt
  -o, --output-directory OUTPUT_DIRECTORY
                        <OUTPUT_DIRECTORY> (optional): Ausgabeverzeichnis für Screenshots (Standard './screenshots/')
  -w, --workers WORKERS
                        <WORKERS> (optional): Anzahl der parallelen Arbeitsprozesse (Standard 4)
  -v, --verbosity       <VERBOSITY> (optional): Ausführlichkeitsgrad, wiederholen zum Erhöhen { -v INFO, -vv DEBUG } (Standard
                        Ausführlichkeit ERROR)
  --no-error-file       <NO_ERROR_FILE> (optional): Keine Datei mit der Liste der URLs fehlgeschlagener Screenshots schreiben (Standard false)
  -z, --single-output-file SINGLE_OUTPUT_FILE
                        <SINGLE_OUTPUT_FILE> (optional): Name einer Datei, die die einzige Ausgabe aller Eingaben darstellt. Bsp. test.png

Parameter zur Eingabeverarbeitung:
  -p, --port PORT       <PORT> (optional): Den angegebenen Port für jedes Ziel in der Eingabeliste verwenden. Bsp: -p 80
  -s, --ssl             <SSL> (optional): SSL/TLS für jede Verbindung erzwingen
  -m, --multiprotocol   <MULTIPROTOCOL> (optional): Screenshots über HTTP und HTTPS für jedes Ziel durchführen

Parameter des Screenshot-Renderers:
  -r, --renderer {phantomjs,chrome,chromium,edge,firefox}
                        <RENDERER> (optional): Zu verwendender Renderer unter 'phantomjs' (veraltet, aber beste Ergebnisse), 'chrome', 'chromium',
                        'edge', 'firefox' (Version > 57) (Standard 'phantomjs')
  --renderer-binary RENDERER_BINARY
                        <RENDERER_BINARY> (optional): Pfad zur Renderer-Ausführbaren, falls es nicht in $PATH gefunden werden kann
  --no-xserver          <NO_X_SERVER> (optional): Falls Sie ohne X-Server arbeiten, wird xvfb-run zum Ausführen des Renderers verwendet
                        (standardmäßig wird versucht, zu erkennen, ob die Umgebungsvariable DISPLAY existiert)

Parameter des Screenshot-Bildes:
  --window-size WINDOW_SIZE
                        <WINDOW_SIZE> (optional): Breite und Höhe der Bildschirmaufnahme (Standard '1200,800')
  -f, --format {pdf,png,jpg,jpeg,bmp,ppm}
                        <FORMAT> (optional, nur phantomjs): Bildausgabeformat angeben, "pdf", "png", "jpg", "jpeg", "bmp"
                        oder "ppm" (Standard 'png')
  -q, --quality [0-100]
                        <QUALITY> (optional, nur phantomjs): Bildqualität angeben, eine ganze Zahl zwischen 0 und 100 (Standard
                        75)
  --ajax-max-timeouts AJAX_MAX_TIMEOUTS
                        <AJAX_MAX_TIMEOUTS> (optional, nur phantomjs): Pro AJAX-Anfrage und maximale URL-Timeout in Millisekunden
                        (Standard '1400,1800')
  --crop CROP           <CROP> (optional, nur phantomjs): Rechteck <t,l,w,h> zum Zuschneiden der Bildschirmaufnahme (Standard auf WINDOW_SIZE:
                        '0,0,w,h'), nur Zahlen, w(idth) und h(eight). Bsp. "10,20,w,h"
  --custom-js CUSTOM_JS
                        <CUSTOM_JS> (optional, nur phantomjs): Pfad einer Datei, die JavaScript-Code enthält, der vor dem
                        Erstellen des Screenshots ausgeführt wird. Bsp: js.txt

Parameter des Screenshot-Labels:
  -l, --label           <LABEL> (optional): Für jeden Screenshot einen weiteren erstellen, der die Ziel-URL anzeigt (erfordert
                        imagemagick)
  --label-size LABEL_SIZE
                        <LABEL_SIZE> (optional): Schriftgröße für das Label (Standard 60)
  --label-bg-color LABEL_BG_COLOR
                        <LABEL_BACKGROUND_COLOR> (optional): Hintergrundfarbe des Labels in ImageMagick (Standard NavajoWhite)
  --imagemagick-binary IMAGEMAGICK_BINARY
                        <LABEL_BINARY> (optional): Pfad zur ImageMagick-Binärdatei (magick oder convert), falls sie nicht in $PATH gefunden werden kann