diff --git a/README.md b/README.md index eda8185..470b404 100644 --- a/README.md +++ b/README.md @@ -61,18 +61,28 @@ Die Anwendung ist dann unter `http://localhost:8080` erreichbar. ### Konfiguration (.env) Kamera-, MQTT- und Inferenz-Einstellungen werden über Umgebungsvariablen -gesteuert. Lege dazu eine `.env`-Datei im Projektverzeichnis an – sie wird -beim Start **automatisch geladen** (`python-dotenv`): +gesteuert. Am einfachsten kopierst du die mitgelieferte Vorlage und passt die +Werte an – die `.env` wird beim Start **automatisch geladen** (`python-dotenv`): ```bash -export CAMERA_URL="http://CAMERA-IP:81/stream" -export MQTT_ENABLED="true" # auf "false" setzen, wenn kein Broker vorhanden -export MQTT_HOST="MQTT-HOST" -export MQTT_PORT=1883 -export MQTT_TOPIC="counter/cam1" -export CAMERA_ID="cam1" +cp .env.example .env +# anschließend .env im Editor öffnen und die Werte anpassen ``` +Die wichtigsten Einstellungen: + +```bash +export CAMERA_URL="http://CAMERA-IP:81/stream" # MJPEG-Stream der Kamera +export MQTT_ENABLED="true" # "false" = ohne Broker starten +export MQTT_HOST="127.0.0.1" # Adresse des MQTT-Brokers +export MQTT_PORT=1883 +export MQTT_TOPIC="vehiclecounter/meine-kamera" # Basis-Topic der Events +export CAMERA_ID="meine-kamera" # Kennung in den Events +``` + +Eine vollständige, kommentierte Liste aller Variablen steht in +[`.env.example`](.env.example). + > 💡 **Ohne MQTT-Broker?** Setze `MQTT_ENABLED="false"` – dann startet die App > ganz normal, zählt und streamt, sendet aber keine MQTT-Events. Ideal zum > Ausprobieren ohne Broker-Setup. (Auch mit `true` startet die App übrigens, @@ -121,7 +131,8 @@ In diesem Beispiel dient eine **ESP32-CAM** als Live-Quelle. Sie stellt einen auswertet und an die Browser-Viewer weiterverteilt. - Die Stream-Adresse wird über die Umgebungsvariable `CAMERA_URL` gesetzt. - Standard ist die typische ESP32-CAM-Adresse (Port `81`, Pfad `/stream`): + Typisch für die ESP32-CAM sind Port `81` und der Pfad `/stream` – `CAMERA-IP` + durch die IP-Adresse der eigenen Kamera ersetzen: ```bash export CAMERA_URL="http://CAMERA-IP:81/stream" ``` diff --git a/app.py b/app.py index 5c65157..1285451 100644 --- a/app.py +++ b/app.py @@ -37,7 +37,7 @@ except ImportError: # --------------------------------------------------------------------------- # Konfiguration # --------------------------------------------------------------------------- -# Kamera-URL ueber Env ueberschreibbar (ESP32-CAM Default: Port 81, /stream). +# Kamera-URL ueber Env setzen (.env). ESP32-CAM: Port 81, Pfad /stream. CAMERA_URL = os.environ.get("CAMERA_URL", "http://CAMERA-IP:81/stream") # --- Inferenz-Tuning (alles per Env ueberschreibbar) -----------------------