doc: many things added and changed

Author: H5N1v2

LICENCE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 H5N1v2 <h5n1@iknox.de>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,68 @@
+# ioBroker.open-meteo-weather
+
+[![NPM version](https://img.shields.io/npm/v/iobroker.open-meteo-weather.svg)](https://www.npmjs.com/package/iobroker.open-meteo-weather)
+[![Downloads](https://img.shields.io/npm/dm/iobroker.open-meteo-weather.svg)](https://www.npmjs.com/package/iobroker.open-meteo-weather)
+![Number of Installations](https://iobroker.live/badges/open-meteo-weather.svg)
+
+**Der Open-Meteo Wetterdienst Adapter für ioBroker.**
+
+Dieser Adapter liefert präzise Wetterdaten, Vorhersagen, Luftqualität und Pollenflug-Informationen von [Open-Meteo.com](https://open-meteo.com/). Die Nutzung ist für den nicht-kommerziellen Gebrauch und weniger als 10.000 tägliche API-Aufrufe ohne Registration für einen API-Key möglich, was die Einrichtung extrem vereinfacht.
+
+---
+
+## Funktionen
+
+* **Aktuelle Wetterdaten:** Echtzeit-Abruf von Temperatur, Feuchtigkeit, Luftdruck und Winddaten.
+* **Flexible Vorhersage:** Konfigurierbare Anzahl an Vorhersagetagen und stündlicher Auflösung.
+* **Luftqualität & Pollenflug:** Optionale Daten für Feinstaub (PM2.5, PM10) sowie verschiedene Pollenarten (Erle, Birke, Gräser, etc.).
+* **Automatisches Cleanup:** Der Adapter bereinigt die Objektstruktur selbstständig, wenn die Vorhersage-Zeiträume in der Konfiguration verkürzt oder geändert werden.
+* **Multi-Language:** Unterstützung für 11 Sprachen (u.a. Deutsch, Englisch, Polnisch, Russisch, Französisch, Chinesisch).
+* **Einheiten-System:** Nahtloser Wechsel zwischen Metrisch (°C, km/h) und Imperial (°F, mph).
+
+---
+
+## Konfiguration
+
+Nach der Installation müssen folgende Felder in den Instanz-Einstellungen ausgefüllt werden:
+
+1.  **Koordinaten (Breitengrad & Längengrad):** Bestimmen Sie den Ort für die Wetterabfrage auf openstreatmap.org.
+2.  **Abfrageintervall:** Zeitabstand in Minuten (Standard: 30 Min).
+3.  **Vorhersage-Tage:** Anzahl der Tage für die tägliche Übersicht (0-16 Tage).
+4.  **Stündliche Vorhersage:** Aktivierung und Anzahl der Stunden pro Tag (z.B. die nächsten 24 Stunden).
+5.  **Optionale Daten:** Checkboxen für Pollenflug und Luftqualität.
+6.  **Einheiten:** Auswahl zwischen Metrisch und Imperial.
+
+---
+
+## Icons & Visualisierung
+
+Der Adapter stellt dynamische Pfade zu Icons bereit, die direkt in Visualisierungen (vis, iQontrol, Jarvis) genutzt werden können.
+
+* **Wetter-Icons:** Zu finden unter `weather.current.icon_url`. Der Adapter unterscheidet automatisch zwischen Tag und Nacht (z.B. Sonne vs. Mond).
+* **Windrichtung:** Statische Pfade unter `wind_direction_icon` zeigen einen Kompass-Pfeil passend zur Gradzahl.
+* **Windböen-Warnung:** Unter `wind_gust_icon` wird ab einer Windgeschwindigkeit von ca. 39 km/h (Bft 6) ein Warn-Icon eingeblendet (Stufen 0-4).
+
+---
+
+## Datenpunkte (Auszug)
+
+| Ordner | Beschreibung |
+|:---|:---|
+| `weather.current` | Aktuelle Messwerte (Temp, Taupunkt, Wind, etc.) |
+| `weather.forecast.dayX` | Tägliche Vorhersage für den Tag X |
+| `weather.forecast.hourly.dayX.hourY` | Stündliche Details pro Tag |
+| `air.current` | Luftqualität und Pollenbelastung als Text und Wert |
+
+---
+
+## Rechtliches & Copyright
+
+### Icons & Bilder
+Die im Adapter enthaltenen Wetter-Icons sowie Windrichtungs-Icons unterliegen dem Urheberrecht des Erstellers. 
+* **Nutzung:** Die Icons sind für die Verwendung innerhalb des ioBroakers lizenziert. Eine kommerzielle Weiterverbreitung oder Nutzung außerhalb dieses Adapters bedarf der Zustimmung des Autors h5n1@iknox.de.
+* **Wetterdaten:** Alle Wetterdaten werden von [Open-Meteo.com](https://open-meteo.com/) bereitgestellt. Bitte beachten Sie deren Nutzungsbedingungen für kommerzielle Zwecke.
+
+### Lizenz
+Dieses Projekt ist unter der **MIT Lizenz** lizenziert - siehe die `LICENSE` Datei für Details.
+
+Copyright (c) 2026 H5N1v2 <h5n1@iknox.de>

admin/i18n/de/translations.json

@@ -1,4 +1,5 @@
 {
+    "koordinates_text": "Koordinaten finden mit openstreetmap",
     "settings_label": "Einstellungen",
     "location_header_text": "Standort-Koordinaten",
     "options_header_text": "Optionen",
@@ -10,15 +11,20 @@
     "days_7": "7 Tage",
     "days_14": "14 Tage",
     "days_16": "16 Tage",
-    "Hours_1": "1 Stunde",
-    "Hours_6": "6 Stunden",
-    "Hours_12": "12 Stunden",
-    "Hours_24": "24 Stunden",
+    "Hours_1": "1 Stunde (0.00 - 01.00 Uhr)->(hour0)",
+    "Hours_6": "6 Stunden (0.00 - 06.00 Uhr)->(hour0-5)",
+    "Hours_12": "12 Stunden (0.00 - 12.00 Uhr)->(hour0-11)",
+    "Hours_24": "24 Stunden (0.00 - 24.00 Uhr)->(hour0-23)",
     "forecastHours_label": "Vorhersage Sunden abrufen",
+    "unit_system_label": "Einheitensystem",
+    "metric_label": "Metrisch (°C, km/h, mm)",
+    "imperial_label": "Imperial (°F, mph, inch)",
     "latitude_label": "Breitengrad (Latitude)",
     "longitude_label": "Längengrad (Longitude)",
     "interval_label": "Update-Intervall",
     "forecastDays_label": "Anzahl der Tage für Vorhersage",
+    "forecastHoursEnabled_label": "Vorhersage für Stunden",
+    "forecastHoursEnabled_help": "(Achtung: Erstellt viele Datenpunkte! Dies kann die Systemlast und den Speicherverbrauch erhöhen.)",
     "airQualityEnabled_label": "Luftqualität & Pollen abrufen",
-    "descriptionText_text": "Dieser Adapter ruft aktuelle Wetterdaten, Vorhersagen sowie Pollenflug- und Luftqualitätsdaten ab."
+    "descriptionText_text": "Dieser Adapter ruft aktuelle Wetterdaten, Vorhersagen sowie Pollenflug- und Luftqualitätsdaten ab\nKoordinaten können auf https://www.openstreetmap.org abgerufen werden."
 }

admin/i18n/en/translations.json

@@ -1,4 +1,5 @@
 {
+    "koordinates_text": "Find Coordinates with openstreetmap",
     "settings_label": "Settings",
     "location_header_text": "Location Coordinates",
     "options_header_text": "Options",
@@ -10,15 +11,20 @@
     "days_7": "7 Days",
     "days_14": "14 Days",
     "days_16": "16 Days",
-    "Hours_1": "1 Hour",
-    "Hours_6": "6 Hours",
-    "Hours_12": "12 Hours",
-    "Hours_24": "24 Hours",
+    "Hours_1": "1 Hour (0.00 - 01.00 AM hour0)",
+    "Hours_6": "6 Hours (0.00 - 06.00 AM hour0-5)",
+    "Hours_12": "12 Hours (0.00 - 12.00 AM hour0-11)",
+    "Hours_24": "24 Hours (0.00 - 24.00 AM hour0-23)",
     "forecastHours_label": "Get forecast hours",
+    "unit_system_label": "Unit System",
+    "metric_label": "Metric (°C, km/h, mm)",
+    "imperial_label": "Imperial (°F, mph, inch)",
     "latitude_label": "Latitude",
     "longitude_label": "Longitude",
     "interval_label": "Update Interval",
     "forecastDays_label": "Forecast Duration (Days)",
+    "forecastHoursEnabled_label": "Fetch forecast hours",
+    "forecastHoursEnabled_help": "(Warning: Creates many data points! This can increase system load and memory usage.)",
     "pollenEnabled_label": "Fetch Pollen Data",
     "airQualityEnabled_label": "Fetch Air Quality Data",
     "descriptionText_text": "This adapter fetches current weather data, forecasts, as well as pollen and air quality data."

admin/i18n/es/translations.json

@@ -1,4 +1,5 @@
 {
+    "koordinates_text": "Buscar Coordenadas con openstreetmap",
     "settings_label": "Ajustes",
     "location_header_text": "Coordenadas de ubicación",
     "options_header_text": "Opciones",
@@ -10,15 +11,20 @@
     "days_7": "7 días",
     "days_14": "14 días",
     "days_16": "16 días",
-    "Hours_1": "1 Hora",
-    "Hours_6": "6 Horas",
-    "Hours_12": "12 Horas",
-    "Hours_24": "24 Horas",
+    "Hours_1": "1 Hora (0.00 - 01.00 AM hour0)",
+    "Hours_6": "6 Horas (0.00 - 06.00 AM hour0-5)",
+    "Hours_12": "12 Horas (0.00 - 12.00 AM hour0-11)",
+    "Hours_24": "24 Horas (0.00 - 24.00 AM hour0-23)",
     "forecastHours_label": "Obtener horas de previsión",
+    "unit_system_label": "Sistema de unidades",
+    "metric_label": "Métrico (°C, km/h, mm)",
+    "imperial_label": "Imperial (°F, mph, inch)",
     "latitude_label": "Latitud",
     "longitude_label": "Longitud",
     "interval_label": "Intervalo de actualización",
     "forecastDays_label": "Días de previsión",
+    "forecastHoursEnabled_label": "Obtener horas de previsión",
+    "forecastHoursEnabled_help": "(Advertencia: Crea muchos puntos de datos! Esto puede aumentar la carga del sistema y el uso de memoria.)",
     "pollenEnabled_label": "Obtener datos de polen",
     "airQualityEnabled_label": "Obtener calidad del aire",
     "descriptionText_text": "Este adaptador obtiene datos meteorológicos actuales, previsiones y datos de polen y calidad del aire."

admin/i18n/fr/translations.json

@@ -1,4 +1,5 @@
 {
+    "koordinates_text": "Trouver des coordonnées avec openstreetmap",
     "settings_label": "Paramètres",
     "location_header_text": "Coordonnées de l'emplacement",
     "options_header_text": "Options",
@@ -10,15 +11,20 @@
     "days_7": "7 jours",
     "days_14": "14 jours",
     "days_16": "16 jours",
-    "Hours_1": "1 heure",
-    "Hours_6": "6 heures",
-    "Hours_12": "12 heures",
-    "Hours_24": "24 heures",
+    "Hours_1": "1 heure (0.00 - 01.00 AM hour0)",
+    "Hours_6": "6 heures (0.00 - 06.00 AM hour0-5)",
+    "Hours_12": "12 heures (0.00 - 12.00 AM hour0-11)",
+    "Hours_24": "24 heures (0.00 - 24.00 AM hour0-23)",
     "forecastHours_label": "Récupérer les heures de prévision",
+    "unit_system_label": "Système d'unites",
+    "metric_label": "Métrique (°C, km/h, mm)",
+    "imperial_label": "Imperial (°F, mph, inch)",
     "latitude_label": "Latitude",
     "longitude_label": "Longitude",
     "interval_label": "Intervalle de mise à jour",
     "forecastDays_label": "Nombre de jours de prévision",
+    "forecastHoursEnabled_label": "Récupérer les heures de prévision",
+    "forecastHoursEnabled_help": "(Attention: Création de nombreux points de données! Ceci peut augmenter la charge du système et le consommation de lamoire.)",
     "pollenEnabled_label": "Récupérer les données de pollen",
     "airQualityEnabled_label": "Récupérer la qualité de l'air",
     "descriptionText_text": "Cet adaptateur récupère les données météo actuelles, les prévisions ainsi que les données sur le pollen et la qualité de l'air."

admin/i18n/it/translations.json

@@ -1,4 +1,5 @@
 {
+    "koordinates_text": "Trova le coordinate con openstreetmap",
     "settings_label": "Impostazioni",
     "location_header_text": "Coordinate di posizione",
     "options_header_text": "Opzioni",
@@ -10,15 +11,20 @@
     "days_7": "7 giorni",
     "days_14": "14 giorni",
     "days_16": "16 giorni",
-    "Hours_1": "1 ora",
-    "Hours_6": "6 ore",
-    "Hours_12": "12 ore",
-    "Hours_24": "24 ore",
+    "Hours_1": "1 ora (0.00 - 01.00 AM hour0)",
+    "Hours_6": "6 ore (0.00 - 06.00 AM hour0-5)",
+    "Hours_12": "12 ore (0.00 - 12.00 AM hour0-11)",
+    "Hours_24": "24 ore (0.00 - 24.00 AM hour0-23)",
     "forecastHours_label": "Recupera ore di previsione",
+    "unit_system_label": "Sistema di unità",
+    "metric_label": "Metrico (°C, km/h, mm)",
+    "imperial_label": "Imperial (°F, mph, inch)",
     "latitude_label": "Latitudine",
     "longitude_label": "Longitudine",
     "interval_label": "Intervallo di aggiornamento",
     "forecastDays_label": "Giorni di previsione",
+    "forecastHoursEnabled_label": "Recupera ore di previsione",
+    "forecastHoursEnabled_help": "(Attenzione: Crea molti punti dati! Questo puo' aumentare la carica del sistema e l'uso della memoria.)",
     "pollenEnabled_label": "Recupera dati sui pollini",
     "airQualityEnabled_label": "Recupera qualità dell'aria",
     "descriptionText_text": "Questo adattatore recupera i dati meteo attuali, le previsioni e i dati sui pollini e sulla qualità dell'aria."

admin/i18n/nl/translations.json

@@ -0,0 +1,30 @@
+{
+    "koordinates_text": "Coördinaten vinden met openstreetmap",
+    "settings_label": "Instellingen",
+    "location_header_text": "Locatiecoördinaten",
+    "options_header_text": "Opties",
+    "interval_15_min": "15 minuten",
+    "interval_30_min": "30 minuten",
+    "interval_60_min": "60 minuten",
+    "days_1": "1 dag",
+    "days_3": "3 dagen",
+    "days_7": "7 dagen",
+    "days_14": "14 dagen",
+    "days_16": "16 dagen",
+    "Hours_1": "1 uur (0.00 - 01.00 uur)->(hour0)",
+    "Hours_6": "6 uur (0.00 - 06.00 uur)->(hour0-5)",
+    "Hours_12": "12 uur (0.00 - 12.00 uur)->(hour0-11)",
+    "Hours_24": "24 uur (0.00 - 24.00 uur)->(hour0-23)",
+    "forecastHours_label": "Uurvoorspelling ophalen",
+    "unit_system_label": "Eenhedenstelsel",
+    "metric_label": "Metrisch (°C, km/h, mm)",
+    "imperial_label": "Imperiaal (°F, mph, inch)",
+    "latitude_label": "Breedtegraad (Latitude)",
+    "longitude_label": "Lengtegraad (Longitude)",
+    "interval_label": "Update-interval",
+    "forecastDays_label": "Aantal dagen voor voorspelling",
+    "forecastHoursEnabled_label": "Voorspelling per uur",
+    "forecastHoursEnabled_help": "(Let op: Maakt veel datapunten aan! Dit kan de systeembelasting en het geheugengebruik verhogen.)",
+    "airQualityEnabled_label": "Luchtkwaliteit & pollen ophalen",
+    "descriptionText_text": "Deze adapter haalt actuele weergegevens, voorspellingen, pollen- en luchtkwaliteitsgegevens op\nCoördinaten kunnen worden verkregen op https://www.openstreetmap.org"
+}

admin/i18n/pl/translations.json

@@ -1,4 +1,5 @@
 {
+    "koordinates_text": "Znajdz koordynaty na mapie openstreetmap",
     "settings_label": "Ustawienia",
     "location_header_text": "Współrzędne lokalizacji",
     "options_header_text": "Opcje",
@@ -10,15 +11,20 @@
     "days_7": "7 dni",
     "days_14": "14 dni",
     "days_16": "16 dni",
-    "Hours_1": "1 godzina",
-    "Hours_6": "6 godzin",            
-    "Hours_12": "12 godzin",
-    "Hours_24": "24 godzin",
+    "Hours_1": "1 godzina (0.00 - 01.00 AM hour0)",
+    "Hours_6": "6 godzin (0.00 - 06.00 AM hour0-5)",            
+    "Hours_12": "12 godzin (0.00 - 12.00 AM hour0-11)",
+    "Hours_24": "24 godzin (0.00 - 24.00 AM hour0-23)",
     "forecastHours_label": "Pobierz godziny prognozy",
     "latitude_label": "Szerokość geograficzna",
+    "unit_system_label": "System jednostek",
+    "metric_label": "Metryczny (°C, km/h, mm)",
+    "imperial_label": "Imperialny (°F, mph, inch)",
     "longitude_label": "Długość geograficzna",
     "interval_label": "Interwał aktualizacji",
     "forecastDays_label": "Liczba dni prognozy",
+    "forecastHoursEnabled_label": "Pobierz godziny prognozy",
+    "forecastHoursEnabled_help": "(Ostrzeżenie: Tworzenie wielu punktów danych! To może zwieksza załadunek systemu i zuzycie pamieci.)",
     "pollenEnabled_label": "Pobieraj dane o pyłkach",
     "airQualityEnabled_label": "Pobieraj dane o jakości powietrza",
     "descriptionText_text": "Ten adapter pobiera aktualne dane pogodowe, prognozy oraz dane o pyłkach i jakości powietrza."

admin/i18n/pt/translations.json

@@ -1,4 +1,5 @@
 {
+    "koordinates_text": "Buscar Coordenadas con openstreetmap",
     "settings_label": "Configurações",
     "location_header_text": "Coordenadas de localização",
     "options_header_text": "Opções",
@@ -10,15 +11,20 @@
     "days_7": "7 dias",
     "days_14": "14 dias",
     "days_16": "16 dias",
-    "Hours_1": "1 hora",
-    "Hours_6": "6 horas",
-    "Hours_12": "12 horas",
-    "Hours_24": "24 horas",
+    "Hours_1": "1 hora (0.00 - 01.00 AM hour0)",
+    "Hours_6": "6 horas (0.00 - 06.00 AM hour0-5)",
+    "Hours_12": "12 horas (0.00 - 12.00 AM hour0-11)",
+    "Hours_24": "24 horas (0.00 - 24.00 AM hour0-23)",
     "forecastHours_label": "Obter horas de previsão",
+    "unit_system_label": "Sistema de unidades",
+    "metric_label": "Métrico (°C, km/h, mm)",
+    "imperial_label": "Imperial (°F, mph, inch)",
     "latitude_label": "Latitude",
     "longitude_label": "Longitude",
     "interval_label": "Intervalo de actualización",
     "forecastDays_label": "Dias de previsão",
+    "forecastHoursEnabled_label": "Obter horas de previsão",
+    "forecastHoursEnabled_help": "(Aviso: Crea muchos puntos de datos! Esto puede aumentar la carga del sistema y el uso de memoria.)",
     "pollenEnabled_label": "Obter dados de pólen",
     "airQualityEnabled_label": "Obter qualidade do ar",
     "descriptionText_text": "Este adaptador obtém dados meteorológicos atuais, previsões e dados de pólen e qualidade do ar."