# Webscreenshot Docker

## Ziel des Projekts:
Automatisches Erstellen von Screenshots von ganzen Webseiten oder einzelnen Elementen (Auswahl via CSS-Selektor) und Speicherung in einem Apache-Webroot.
Die Screenshots werden in einem konfigurierbaren Intervall erstellt und nur gespeichert, wenn der aktuelle Screenshot von der vorheringen Version abweicht.

**Features:**

- Multi-URL-Support
- Flexible Dateinamen der Screenshots
- Skalierung der Screenshots in Relation zur Ursprungsgröße
- Anpassbare Größe bei Auswahl einzelner CSS-Elemente (Höhe und Breite)
- Individuelles Check-Intervall pro URL
- Speicherung nur bei Änderung

---

## Projektstruktur

	webscreen/
	 |-- docker-compose.yml
	 |-- Dockerfile
	 |-- requirements.txt
	 |-- app/
	      |-- webscreenshot.py
	      |-- urls.csv

---

## Konfiguration
Die Hauptkonfiguration erfolgt über die Datei `urls.csv`:

| Spalte           | Beschreibung |
|-----------------|-------------|
| `url`            | URL der Webseite |
| `filename`       | Name der Ausgabedatei (z.B. `example.png`) |
| `scale`          | Skalierungsfaktor (z.B. 0.5 für 50%) |
| `selector`       | CSS-Selector des Elements, das gescreenshotet werden soll; leer = ganze Seite |
| `element_width`  | Breite des Elements vor Screenshot (px); leer = keine Änderung |
| `element_height` | Höhe des Elements vor Screenshot (px); leer = keine Änderung |
| `interval_minutes` | Intervall für wiederholten Screenshot in Minuten; leer = Docker-Variable |

Für den Fall dass bei der Skalierung oder beim Intervall keine Eintragung vorgenommen wird werden die "Standartwerte" aus den docker-compose environment-Variabeln
genommen. Diese können in der `docker-compose.yml` angepasst werden.

---

## Installation und Nutzung

1. Output-Verzeichnis erstellen:
	mkdir output

2. `docker-compose.yml` ggf. anpassen

3. `urls.csv` anpassen

4. Stack starten
	docker compose up -d --build

5. Screenshots sind abrufbar unter `http://localhost:8080/example.png

---

## Hinweise

- Im Docker-Stack werden 2 Container erstellt: ein apache-Container um die Screenshots zugänglich zu machen und ein webscreenshot-Container, welcher das eigentliche python-Skript ausführt.
- Es wird empfohlen, den apache-Container hinter einem reverse proxy zu betreiben, so lassen sich die Screenshots per https abrufen.
- Der Port des apache-Servers kann regulär frei in der `docker-compose.yml` geändert werden