README: auf .env.example verweisen + echte Werte entfernen

- 'cp .env.example .env' als empfohlener Einstieg dokumentiert
- Broker-IP/Topic/Kamera-IP aus README und app.py-Default durch
  Platzhalter ersetzt (versehentlich aus lokalem Setup uebernommen)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-01 14:54:35 +02:00
parent 9c325dbff3
commit 5545d7d837
2 changed files with 21 additions and 10 deletions

View File

@@ -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"
```

2
app.py
View File

@@ -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) -----------------------