# Benutzerhandbuch > Für Nutzerinnen und Nutzer der BENSA-Wetter-App. Einstieg: [START_HERE.md](START_HERE.md). ## Installation > Ausführliche technische Beschreibung des Installationsverhaltens (was genau `beforeinstallprompt` > auslöst, was iOS/Desktop unterscheidet, was die Installation NICHT ist): siehe > [pwa-installation.md](pwa-installation.md). ### Android/Chrome 1. Die App-Adresse im Chrome-Browser öffnen. 2. Chrome zeigt meist automatisch einen Hinweis "Zum Startbildschirm hinzufügen" bzw. einen Installations-Button in der App selbst (Reiter „Mehr"). 3. Antippen und bestätigen — die App erscheint danach wie eine normale App auf dem Startbildschirm. Zusätzlich gibt es für Android eine **native Testversion** (eigenständige APK, kein Browser-Tab) mit vollständigem Wetter-Dashboard - Download, Installation und Aktualisierung über den PWA-Abschnitt „Apps & Geräte" (Reiter „Mehr"), ausführlich beschrieben in [android-release-distribution.md](android-release-distribution.md). Das ist **nicht** dasselbe wie die Browser-installierte PWA oben. ### iPhone/iPad (Safari) Safari kennt keine automatische Installation. Stattdessen: 1. Die App-Adresse in **Safari** öffnen (nicht in Chrome oder einer anderen Browser-App). 2. Auf das Teilen-Symbol tippen (Quadrat mit Pfeil nach oben). 3. „Zum Home-Bildschirm" auswählen. 4. Bestätigen — danach lässt sich die App wie eine normale App vom Home-Bildschirm starten, inklusive Push-Benachrichtigungen (siehe Abschnitt „Push" unten). ### Desktop (Chrome/Edge) Im Adressfeld erscheint ein Installations-Symbol; alternativ über das Browser-Menü „App installieren" wählen. ### Unterschied Browseransicht und installierte App Inhaltlich identisch. Die installierte App startet ohne Browser-Adressleiste, merkt sich die zuletzt geöffnete Ansicht und kann (nach Erlaubnis) Benachrichtigungen zeigen. ### Aktualisierung Die App aktualisiert sich beim nächsten Öffnen mit Internetverbindung automatisch im Hintergrund („Service Worker"). Ist eine neue Version bereit, reicht meist ein einmaliges Schließen und erneutes Öffnen. Bleibt die Ansicht dennoch veraltet, siehe [troubleshooting-for-beginners.md](troubleshooting-for-beginners.md#alte-ansicht). ### App zurücksetzen Über die Browser-Einstellungen "Website-Daten löschen" für die App-Adresse — danach lädt die App beim nächsten Öffnen alles neu. Lokale Einstellungen (Theme, Push-Kategorien) gehen dabei verloren. ### Native App und Home-Screen-Widgets (v1.9.7) Zusätzlich zur installierbaren PWA oben gibt es seit v1.9.7 eine schlanke native App-Hülle mit Home-Screen-Widgets für Android (repository-seitig fertig, siehe [project-status-v1.9.7.md](project-status-v1.9.7.md)) sowie vorbereiteten iOS-Quellcode. **Beide sind noch nicht im Play Store/App Store veröffentlicht** — dieser Abschnitt beschreibt, was die native App zusätzlich zur PWA bietet, sobald sie verfügbar ist: - Ein Widget in drei Größen für den Home-Screen (Temperatur, Zustand, Warnstatus, Aktualität). - Ein Tippen auf das Widget öffnet direkt die passende Ansicht in der App. - Alle fachlichen Inhalte (Wetterwerte, Warnungen, Radar) bleiben identisch zur PWA — die native App zeigt nur eine kompaktere Zusammenfassung und öffnet für Details dieselbe Web-Ansicht. ## Navigation | Reiter | Inhalt | |---|---| | **Aktuell** | Wetterlage jetzt: Temperatur, gefühlte Temperatur, Regen, Wind, UV, Datenstand | | **Prognose** | Kommende Tagesabschnitte (heute/morgen/übermorgen) | | **Warnungen** | Amtliche Warnungen und eigene Wetterhinweise, getrennt | | **Radar** | Niederschlagsradar-Karte | | **Lernen** | Zusammenfassung des Hintergrund-Lernsystems (Schattenbetrieb) | | **Mehr** | Darstellung, Benachrichtigungen, Hilfe, Datenschutz, Version | ## Aktuelle Wetterlage - **Temperatur**: gemessene bzw. vorhergesagte Lufttemperatur. - **Gefühlte Temperatur**: berücksichtigt zusätzlich Wind und Luftfeuchtigkeit — kann deutlich von der reinen Lufttemperatur abweichen (siehe [how-to-read-weather-data.md](how-to-read-weather-data.md)). - **Wetterzustand**: Symbol/Text (z. B. "bewölkt", "Regen"). - **Regenwahrscheinlichkeit/-menge**: siehe [how-to-read-weather-data.md](how-to-read-weather-data.md#niederschlag). - **Wind/Böen**: mittlere Geschwindigkeit und kurze, stärkere Spitzenwerte. - **UV**: UV-Index, siehe [how-to-read-weather-data.md](how-to-read-weather-data.md#uv). - **Datenstand/Quellenstatus**: wann die Daten zuletzt aktualisiert wurden und ob alle Quellen gerade erreichbar sind. ### Live-Modus (v1.9.8) Im Reiter „Aktuell" gibt es oberhalb der Wetterwerte einen Schalter **„Live-Modus (automatische Aktualisierung)"**. Wichtig zu wissen: - **Live bedeutet: automatische Aktualisierung in festen Abständen** — normalerweise alle 5 Minuten, bei einer aktiven amtlichen Warnung bis zu alle 2 Minuten. Es ist **keine sekundengenaue Messstation** und **kein echtes Echtzeit-Streaming** — die App fragt in diesem Rhythmus denselben Wetterstand erneut ab, der auch ohne Live-Modus per Knopfdruck abrufbar ist. - Ist der Schalter aktiviert, erscheint eine kompakte Statuszeile mit Symbol, Text und Uhrzeit, z. B.: „Aktuell · zuletzt aktualisiert 14:32 Uhr" oder „Daten verzögert · letzter Stand 13:40 Uhr". - Ein Countdown zeigt die Zeit bis zur nächsten Aktualisierung. - Bei einer Verbindungsunterbrechung erscheint „Verbindung unterbrochen" und die zuletzt bekannten Werte bleiben sichtbar — es werden keine Werte gelöscht oder durch Platzhalter ersetzt. - Der Live-Modus pausiert automatisch, sobald der Browser-Tab/die App in den Hintergrund wechselt, und aktualisiert beim Zurückkehren einmalig sofort. - Eine manuelle Aktualisierung über den Knopf „🔄 Aktualisieren" ist jederzeit zusätzlich möglich, unabhängig davon, ob der Live-Modus ein- oder ausgeschaltet ist. - Die Einstellung (ein/aus) wird lokal im Browser gemerkt und bleibt beim nächsten Öffnen erhalten. ## Beobachtungskarte ("Jetzt gemessen") (v1.9.10, erweitert v1.9.13) Im Reiter „Aktuell" zeigt die oberste Karte eine echte Beobachtung der zuletzt bekannten DWD-Wetterstation (Bright-Sky-Beobachtungsdaten), **keine** Vorhersage. Ausführlich: [observation-user-guide.md](observation-user-guide.md). Wichtig zu wissen: - **Messwert vs. Prognose sind bewusst getrennt.** Diese Karte zeigt, was die Station zuletzt tatsächlich gemessen hat; die Prognose-Karte darunter zeigt weiterhin eine Modellvorhersage. Beide können voneinander abweichen — das ist normal und kein Fehler (Messstation vs. Gitterpunkt-Modell, siehe [faq.md](faq.md)). - **Die Überschrift richtet sich ehrlich nach dem Alter der Messung** (v1.9.13): „Aktuell gemessen" bis 15 Minuten, „Letzte Messung" bis 60 Minuten, danach „Letzte verfügbare Messung" mit einem zurückhaltenden, gelben Hinweis (keine Alarmoptik). Darunter stehen Station, Messzeitpunkt (mitteleuropäische Zeit) und das genaue Alter, z. B. „Messwert 2 Stunden 25 Minuten alt". Eine weitere Zeile zeigt zusätzlich, wann der Server diesen Wert zuletzt aus der Importstrecke übernommen hat ("Messdaten auf dem Server zuletzt geprüft"). Eine Entfernungsangabe zur Station gibt es derzeit nicht. - **Automatische Stationsprüfung** (v1.9.17): beim Öffnen der App und danach in regelmäßigen Abständen (grundsätzlich alle 10 Minuten, früher bei einem sehr alten Messwert) prüft die App im Hintergrund selbstständig mehrere nahegelegene Stationen und aktualisiert die Karte, ohne dass ein Klick nötig ist. Dabei erscheint eine kurze, zurückhaltende Statuszeile wie „Messstationen automatisch um 09:10 Uhr geprüft." — keine aufdringliche Meldung. Ausführlich: [automatic-observation-refresh.md](automatic-observation-refresh.md). - **Button „Messdaten neu laden"**: löst dieselbe aktive Stationsprüfung sofort und gezielt aus, statt auf die nächste automatische Prüfung zu warten — meldet dabei ausführlich Station, Entfernung und Messzeitpunkt. Löst nie eine E-Mail oder Push-Benachrichtigung aus. - Ist gerade keine aktuelle Stationsbeobachtung verfügbar (Quelle nicht erreichbar), zeigt die Karte das über einen klaren Status statt einen erfundenen Wert. - Diese Karte ist Teil des ganz normalen Snapshot-Abrufs, aktualisiert sich aber seit v1.9.17 zusätzlich eigenständig im Hintergrund (siehe oben) — es läuft weiterhin keine eigene Messstation für BENSA Wetter (siehe [live-observation.md](live-observation.md) für die technische Grundlage). ## App verwalten und deinstallieren (v1.9.17) Im Reiter „Mehr" zeigt die Karte „App verwalten", ob die App gerade als installierte App oder im Browser-Tab läuft, sowie eine zur erkannten Plattform passende Anleitung zum Entfernen der App (z. B. Android: Symbol gedrückt halten → Deinstallieren; Windows: im Startmenü rechtsklicken → Deinstallieren). Diese Seite kann eine installierte App **nicht selbst** entfernen — das übernimmt ausschließlich das Betriebssystem/der Browser. Ausführlich: [pwa-installation-management.md](pwa-installation-management.md). ## Wetterkameras in der Umgebung (v1.9.17) Im Reiter „Radar" zeigt die Karte „Wetterkameras in der Umgebung" Name, Ort, Entfernung und Anbieter nahegelegener offizieller Wetterkameras. Kamerabilder werden **nicht automatisch** geladen — nur ein Klick auf „Beim Anbieter öffnen" führt zur offiziellen Seite des jeweiligen Betreibers. Ausführlich: [weather-camera-evaluation.md](weather-camera-evaluation.md). ## Radar - Schnellzugriff Der Reiter „Radar" (siehe unten) ist auch direkt aus der Karte „Aktuell" über einen Schnelllink erreichbar, ohne erst durch die Reiter zu navigieren. Ausführlich: [radar-user-guide.md](radar-user-guide.md). ## Prognose - **Tagesabschnitte**: Vormittag/Mittag/Nachmittag/Abend/Nacht, je nach Tageszeit. - **Heute/Morgen**: die Überschrift zeigt den tatsächlichen Kalendertag (Europe/Berlin). - **Nacht über Mitternacht**: ein Nachtabschnitt kann über Mitternacht hinausreichen — die Uhrzeiten in der Karte sind maßgeblich, nicht die Reihenfolge auf dem Bildschirm. - **Messwert vs. Prognose**: bereits vergangene Abschnitte zeigen tatsächliche Beobachtungen, kommende zeigen eine Vorhersage. - **Fehlende Daten**: einzelne Werte können fehlen, wenn eine Quelle gerade nicht erreichbar war — das wird nicht stillschweigend durch eine erfundene Zahl ersetzt. - **Kein Leerstand am Abend (v1.9.12)**: die Prognose zeigt immer den noch laufenden heutigen Abschnitt plus den kompletten, datenseitig verfügbaren Folgetag — sie wird nicht leer, nur weil der heutige Tag fast vorbei ist. ## Warnungen Siehe ausführlich [how-to-understand-warnings.md](how-to-understand-warnings.md). Kurzfassung: die App zeigt **aktive amtliche Warnungen** (DWD/NINA-BBK) zuerst und deutlich hervorgehoben, danach **eigene Wetterhinweise** (BENSA, keine amtliche Warnung) und zuletzt **kürzlich beendete** Warnungen. Jede Karte zeigt zusätzlich einen verständlichen Gültigkeitszeitraum in Europe/Berlin („Gültig: …" bei amtlichen Warnungen, „Erwarteter Zeitraum: …" bei eigenen Hinweisen). Ein „Quellenstatus" zeigt, ob die Warnquelle gerade erreichbar ist. ## Radar Siehe ausführlich [radar-user-guide.md](radar-user-guide.md). ## Lokales Radar-Nowcasting (v1.10.0) Unterhalb der Radarkarte zeigt die Karte „Lokales Radar-Nowcasting" eine eigene, vorsichtige Einschätzung, ob sich ein Niederschlagsgebiet dem Zielort nähert — nie eine exakte Ankunftszeit, nie eine amtliche Warnung. Ausführlich: [nowcasting-user-guide.md](nowcasting-user-guide.md), bekannte Grenzen: [nowcasting-limitations.md](nowcasting-limitations.md). ## Push (Benachrichtigungen) 1. Im Reiter „Mehr" auf „Benachrichtigungen aktivieren" tippen und die Browser-Berechtigung erteilen (auf dem iPhone vorher zum Home-Bildschirm hinzufügen, siehe oben). 2. Darunter lassen sich einzelne Kategorien an-/abschalten (z. B. amtliche Warnungen, Gewitter, Starkregen, Hitze/UV). 3. „Testnachricht senden" prüft, ob Benachrichtigungen tatsächlich ankommen. 4. Jede Nachricht ist eindeutig gekennzeichnet: „Amtliche DWD-Warnung: …" oder „BENSA Wetterhinweis: …" — niemals verwechselbar. 5. Eine erwartete Nachricht kann ausbleiben, wenn: die Kategorie deaktiviert ist, ein Tages-/ Stundenlimit erreicht wurde, dieselbe Meldung kürzlich schon gesendet wurde (Dublettenschutz), oder kein Ereignis vorlag, das die Schwelle für eine Benachrichtigung überschreitet. ## Datenschutz - Es gibt **kein Benutzerkonto** und **keine E-Mail-Anmeldung** für die App selbst. - Bei aktivierten Push-Benachrichtigungen wird eine **anonyme Geräte-Kennung** plus die technische Push-Adresse des Browsers gespeichert — keine Standortverfolgung, kein Name, keine E-Mail. - Push lässt sich jederzeit über „Benachrichtigungen deaktivieren" widerrufen; die gespeicherte Registrierung wird dabei gelöscht. - Ausführlich: [push-privacy.md](push-privacy.md).