MMM-NINA

Eine simple Client Implementierung der NINA Warn App API für die MagicMirror² Plattform. Klicke hier für den Forum Thread.

Feedback und Mithilfe willkommen.

Wenn du meine Arbeit schätzt, dann freue ich mich über einen bescheidenen Beitrag zu meinem nächsten Feierabend-Bier.

• Das Modul ruft periodisch die NINA API auf und ermittelt Warnmeldungen für deinen Kreis.
• Es können Alarme mehrerer Städte/Gemeinden gleichzeitig abgerufen werden.
• Identische Warnungen können zusammengefasst werden.
• 2 unterschiedliche Themes

Navigiere in das MagicMirror/modules Verzeichnis und führe folgendes Kommando aus, um das Projekt auf deine Festplatte zu klonen:

git clone https://github.com/jalibu/MMM-NINA

Um das Modul zu aktualisieren, navigiere in das Modulverzeichnis und führe ein git pull aus:

cd ~/MagicMirror/modules/MMM-NINA
git pull

Ermittle zunächst den amtlichen Gemeindeschlüssel (AGS) deines Ortes:

• Über das Gemeindeverzeichnis der Statistikämter (einfach für manuelle Suche).
• Alternativ über die maschinenlesbare Liste von xrepository.de.

Binde das Modul anschließend in die MagicMirror-Konfiguration config/config.js ein:

    {
        module: "MMM-NINA",
        position: "top_right",
        config: {
            ags: ["110000000000"], // Liste der Gemeinden, die abgefragt werden sollen
            downgradeLhpSeverity: false,
            downgradeCancelSeverity: true,
            hideCancelledWarnings: false,
            excludeProviders: [], // Mögliche Werte ["MOWAS", "DWD", "BIWAPP", "LHP"]
            maxAgeInHours: 6,
            maxWidth: "200px",
            mergeAlertsById: true,
            mergeAlertsByTitle: true,
            orderBySeverity: true,
            showIcon: true,
            showDate: true,
            showCity: true,
            showNoWarning: true,
            theme: "top", // Erlaubte Werte: top, top-floating, side
            updateIntervalInSeconds: 120,
        }
    },

This module is written in TypeScript and compiled with Rollup. The source files are located in the /src folder.

Contribution for this module is welcome!

Development Workflow:

# Start development with watch mode
node --run dev:watch

# Before committing, run full quality check
node --run test

# Auto-fix any linting/formatting issues
node --run lint:fix

# When ready for release
node --run release

Git Hooks:

Folgende Git Hooks sind automatisch aktiviert:

• pre-commit: Führt node --run test aus (verhindert untesteten Code)
• pre-push: Führt node --run build aus (verhindert nicht-kompilierten Code)

Hinweis: Dieser Abschnitt ist für normale Nutzer nicht relevant. In größeren Abständen sollten die Gemeindeschlüssel jedoch aktuallisiert werden, um neue Gemeinden zu unterstützen.

Die Datei src/backend/Regionalschluessel_2026-03-31.json enthält alle deutschen Gemeinden mit ihren amtlichen Gemeindeschlüsseln (AGS). Diese Datei wird jährlich vom Statistischen Bundesamt aktualisiert.

Um die Datei zu aktualisieren:

1. Download der neuesten Version (ersetze YYYY-MM-DD mit dem aktuellen Datum, z.B. 2026-07-31):

cd ~/MagicMirror/modules/MMM-NINA/src/backend
curl -s "https://www.xrepository.de/api/xrepository/urn:de:bund:destatis:bevoelkerungsstatistik:schluessel:rs_YYYY-MM-DD/download/Regionalschl_ssel_YYYY-MM-DD.json" -o Regionalschluessel_YYYY-MM-DD.json

2. Update des Imports in src/backend/Utils.ts:

// Ändere von:
import { daten } from './Regionalschluessel_2026-03-31.json'

// zu:
import { daten } from './Regionalschluessel_YYYY-MM-DD.json'

3. Formatiere die neue Datei mit Prettier:

cd ~/MagicMirror/modules/MMM-NINA
node --run lint:fix

Die neuesten Versionen sind verfügbar unter:

• xrepository.de - Regionalschlüssel
• Statistisches Bundesamt

This project is licensed under the MIT License - see the LICENSE file for details.