awtrix-ng-nimbus-clock-weather-PL

NimbusPL — opis do AWTRIX Hub

Strona: https://github.com/olo81/awtrix-ng-nimbus-clock-weather-PL

**EN **

Polish Nimbus for AWTRIX NG 52×16 — 3 clock faces, Open-Meteo weather (24 states), PM2.5 air quality, IMGW Meteoalarm, moon phase & wind gusts.

PL:

Polski Nimbus dla AWTRIX NG 52×16 — 3 tarcze zegara, pogoda Open-Meteo (24 stany), jakość powietrza PM2.5, Meteoalarm IMGW, faza księżyca i porywy wiatru.

NimbusPL — Polish clock with weather, PM2.5 and Meteoalarm

NimbusPL is a fully Polish-localized fork of Nimbus for AWTRIX NG / AWTRIX Light
on 52×16 LED panels (e.g. Ulanzi TC002). It combines a clock with a calendar, weather
forecast, air quality, weather warnings and room sensors in one configurable carousel.

🇵🇱 The entire app — options, descriptions and hints in the AWTRIX web panel — is 100% in Polish.

Features

• 🎨 3 clock faces — kartka (tear-off calendar sheet), pierścień (digital face with a
  rotating seconds ring), duży (full-width clock with scrolling date and weather line)
• 🌦️ Open-Meteo weather — all 24 WMO states with pixel icons and animated precipitation
  (rain, snow, hail, freezing drizzle…), descriptions in 6 languages (Polish by default)
• 🍃 PM2.5 air quality from Open-Meteo Air Quality — no external sensors needed;
  6 color thresholds based on EPA AQI / Polish GIOŚ index (green → yellow → orange → red →
  purple → navy)
• 🚨 Meteoalarm (IMGW) — official Polish weather warnings; the app auto-detects your
  powiat (TERYT) from Lat/Lon (380 powiats built in) or accepts a manual TERYT code;
  color-coded by severity (🟡 1 / 🟠 2 / 🔴 3), with configurable frequency and duration
• 🌬️ Wind gust tile — joins the carousel automatically when gusts exceed a threshold
  (default 40 km/h)
• 🌙 Moon phase — continuously rendered terminator (not just 8 phases), with phase names
  on the big face
• 🏠 Room sensors — indoor temperature and humidity via MQTT (Home Assistant); panels
  are skipped automatically when no data arrives
• 🌙 Night mode — auto-dimming with paused rotation at chosen hours
• 🧹 Wiper effect — a black cleaning bar sweeps the matrix every 5 minutes to prevent
  LED burn-in

Carousel

9 switchable panels, ordered by a simple number list
(e.g. 1,2,3,4,5,6,7,8,9): weather → wind gusts → date → temperature → PM2.5 → room →
humidity → moon → Meteoalarm.

Quick start

1. Install the script via the Hub (or copy dist/nimbus-tc002.ax to /apps/ on your device)
2. Enter your Lat / Lon in the app settings — used for weather, PM2.5 and Meteoalarm
3. Enable Włącz Meteoalarm to receive IMGW warnings (optional: set a TERYT code manually)
4. Optional: set MQTT topics for room temperature/humidity

Credits

• AkdM — author of the original Nimbus app
• olo81 — Polish localization, PM2.5, Meteoalarm/TERYT, moon phase, wind gusts,
  wiper effect and stability fixes

Source & full documentation: https://github.com/olo81/awtrix-ng-nimbus-clock-weather-PL

NimbusPL — polski zegar z pogodą, PM2.5 i Meteoalarmem

NimbusPL to w pełni spolszczony fork aplikacji Nimbus dla AWTRIX NG / AWTRIX Light
na matrycach 52×16 (np. Ulanzi TC002). Łączy zegar z kalendarzem, prognozą pogody, jakością
powietrza, ostrzeżeniami meteorologicznymi i czujnikami pokojowymi w jednej konfigurowalnej
karuzeli.

🇵🇱 Cała aplikacja — opcje, opisy i podpowiedzi w panelu WWW AWTRIX — jest w 100% po polsku.

Funkcje

• 🎨 3 tarcze zegara — kartka (zrywana kartka kalendarza), pierścień (tarcza cyfrowa
  z obracającym się pierścieniem sekundnika), duży (zegar na całą szerokość z przewijaną
  datą i opisem pogody)
• 🌦️ Pogoda Open-Meteo — wszystkie 24 stany WMO z pikselowymi ikonkami i animowanymi
  opadami (deszcz, śnieg, grad, marznąca mżawka…), opisy w 6 językach (domyślnie polski)
• 🍃 Jakość powietrza PM2.5 z Open-Meteo Air Quality — bez zewnętrznych czujników;
  6 progów kolorystycznych wg EPA AQI / indeksu GIOŚ (zielony → żółty → pomarańczowy →
  czerwony → fioletowy → granatowy)
• 🚨 Meteoalarm (IMGW) — oficjalne ostrzeżenia pogodowe; aplikacja sama wyznacza
  najbliższy powiat (TERYT) ze współrzędnych Lat/Lon (380 powiatów wbudowanych) lub przyjmuje
  ręczny kod TERYT; kolor wg stopnia ostrzeżenia (🟡 1 / 🟠 2 / 🔴 3), konfigurowalna
  częstotliwość i czas wyświetlania
• 🌬️ Porywy wiatru — kafelek dołącza do rotacji, gdy porywy przekroczą próg
  (domyślnie 40 km/h)
• 🌙 Faza księżyca — terminator rysowany w sposób ciągły (nie tylko 8 faz), z nazwami faz
  na dużej tarczy
• 🏠 Czujniki pokojowe — temperatura i wilgotność w pomieszczeniu przez MQTT
  (Home Assistant); panele same znikają, gdy brak danych
• 🌙 Tryb nocny — automatyczne przyciemnienie i wstrzymanie rotacji w wybranych godzinach
• 🧹 Efekt wycieraczki — czarny pas czyszczący przechodzi co 5 minut, chroniąc matrycę
  przed powidokami (burn-in)

Karuzela

9 paneli z przełącznikami, kolejność przez prostą listę numerów
(np. 1,2,3,4,5,6,7,8,9): pogoda → porywy wiatru → data → temperatura → PM2.5 → pokój →
wilgotność → księżyc → meteoalarm.

Szybki start

1. Zainstaluj skrypt przez Hub (albo skopiuj dist/nimbus-tc002.ax do /apps/ na zegarze)
2. Podaj Lat / Lon w ustawieniach aplikacji — służą do pogody, PM2.5 i meteoalarmu
3. Włącz Włącz Meteoalarm, żeby dostawać ostrzeżenia IMGW (opcjonalnie: kod TERYT ręcznie)
4. Opcjonalnie: ustaw ścieżki MQTT dla czujników pokojowych

Autorzy

• AkdM — autor oryginalnej aplikacji Nimbus
• olo81 — polska lokalizacja, PM2.5, Meteoalarm/TERYT, faza księżyca, porywy wiatru,
  efekt wycieraczki i poprawki stabilności

Źródła i pełna dokumentacja: https://github.com/olo81/awtrix-ng-nimbus-clock-weather-PL