@maschinenlesbar.org/nina-warnungen-cli
    Preparing search index...

    @maschinenlesbar.org/nina-warnungen-cli

    nina-warnungen-cli

    CI Release npm

    Website: English · Deutsch — command reference, guides and API docs

    Query Germany's federal civil-protection warning system from your terminal. nina is a command-line tool over the open NINA API (warnung.bund.de): fetch current warnings by source, look up the full detail or geometry of any alert, check a region by its official key, and browse the MoWaS archive — as clean JSON you can pipe straight into jq.

    • Works out of the box — no account, no API key, no configuration. Install and query.
    • All sources in one tool — MoWaS, KATWARN, BIWAPP, DWD severe-weather, flood (LHP) and police.
    • Clean JSON output — pretty-printed by default, --compact for one-line/scripting.
    • GeoJSON support — download a warning's affected-area geometry directly to a file.
    • Region check — one small request lists every warning affecting a district, by its official regional key.

    Want to use this as a TypeScript library or understand how it's built? See DEVELOPING.md.

    npm i -g @maschinenlesbar.org/nina-warnungen-cli

    This installs the nina command. Requires Node.js 20+.

    Check it works:

    nina --help

    No setup needed — the API is open and read-only. Your first query:

    nina map-data dwd

    Returns the current severe-weather warnings from the DWD (Deutscher Wetterdienst). Pull out just the headlines and severity levels with jq:

    nina map-data dwd | jq '.[] | {id, severity: .severity, headline: .i18nTitle.de}'

    Take a warning id from those results and fetch its full CAP record:

    nina warning get mow.DE-BY-A-W083-20240101

    sources                                list the valid warning sources
map-data <source>                      current warnings from a source
                                       (mowas | katwarn | biwapp | dwd | lhp | police)
warning  get <id>                      full CAP warning by identifier
warning  geojson <id>                  warning geometry as GeoJSON (-o to save)
dashboard <ars>                        warnings for a district (12-digit ARS, last 7 digits 0)
archive  mapping <id>                  MoWaS revision history for an identifier
archive  get <id>                      a specific archived MoWaS warning
reference notfalltipps                 emergency-preparedness tips (German)
reference event-codes                  CAP event-code catalogue
reference data-version                 version/hash of NINA's labels data (not warnings)
    Value Warning type
    mowas MoWaS — modular civil-protection alerts
    katwarn KATWARN — municipal/regional alerts
    biwapp BIWAPP — municipal alerts
    dwd DWD — severe-weather (national met service)
    lhp LHP — cross-state flood warnings
    police Police incident reports

    The canonical list is always available at runtime via nina sources.

    A few recipes to get going — see Usage.md for the full, use-case-driven set.

    # Current flood warnings
    nina map-data lhp

    # Filter to only Severe or Extreme warnings across a source
    nina map-data mowas | jq '[.[] | select(.severity == "Severe" or .severity == "Extreme")]'

    # Full detail for one warning (id from a map-data entry)
    nina warning get mow.DE-SL-SLS-W038-20260113-000

    # Save the affected-area geometry as a GeoJSON file
    nina warning geojson mow.DE-SL-SLS-W038-20260113-000 -o warn.geojson

    # All warnings currently affecting a district (district-level ARS; 055150000000 = Münster)
    nina dashboard 055150000000

    # Version/hash of NINA's labels data — it does not change when warnings change,
    # so watch a district by re-running `dashboard` and comparing ids instead
    nina --compact reference data-version

    Every command prints pretty JSON to stdout. Errors and diagnostics go to stderr, so piping stdout into jq stays clean.

    # Count warnings for a region
    nina dashboard 055150000000 | jq 'length'

    # Extract severity + headline from all DWD entries
    nina map-data dwd | jq '.[] | {severity, title: .i18nTitle.de}'

    Use --compact for single-line JSON in pipelines and logs:

    nina --compact map-data dwd | jq -c '.[]'

    --compact (and every global option) works before or after the command — both nina --compact map-data dwd and nina map-data dwd --compact do the same thing.

    An identifier that begins with - would be parsed as an option; pass it after a -- separator: nina warning get -- -odd.identifier.

    Exit codes make the CLI easy to use in scripts:

    Code Meaning
    0 success (also --help / --version)
    1 error — network failure, parse error, unexpected problem
    4 warning not found (404)
    non-zero bad usage / invalid argument (commander parse error)
    • command not found: nina — the global npm bin directory isn't on your PATH. Run npm bin -g to find it and add it, or run via npx @maschinenlesbar.org/nina-warnungen-cli ….
    • Exit 4 / "not found" — the warning identifier doesn't exist or has expired. Re-fetch it from a fresh map-data or dashboard result; identifiers change as warnings are issued and cancelled.
    • Exit 1 / network error — connectivity, DNS, or a timeout. Try again, or raise the limit with --timeout 60000. For flaky networks increase retries: --max-retries 5.
    • Empty result from map-data — the source has no active warnings right now. Try a different source or come back later.
    • warning geojson prints non-JSON content-type warning — the API returned an unexpected content-type (e.g. a gateway error page). The bytes are still written, but check whether the identifier is valid.

    These apply to every command and may be given before or after it:

    Option Description
    -V, --version Print the version number
    -h, --help Show help for the program or a command
    --compact Print JSON on a single line instead of pretty-printed
    -o, --output <file> Write the command's output to a file instead of stdout (JSON commands and downloads alike)
    --base-url <url> API base URL (default https://warnung.bund.de)
    --timeout <ms> Per-request timeout (default 30000; 0 waits indefinitely; at most 2147483647)
    --user-agent <ua> User-Agent header value
    --max-retries <n> Retries for transient 429/503 responses (default 2, max 10 — higher is rejected)
    --max-response-bytes <n> Cap response body size in bytes (0 = unlimited; default 100 MiB)

    Numeric options accept only plain non-negative decimal integers — values like 5.0, 0x10, 1e3, or -1 are rejected as usage errors.

    • SKILLS.md — Claude Code Agent Skills that drive this CLI for live warning briefings, region watches and GeoJSON maps.
    • Usage.md — full use-case-driven cookbook.
    • GLOSSARY.md — every command, source, domain term and exit code explained.
    • DEVELOPING.md — TypeScript library usage, architecture, testing, CI.

    This CLI is a client — it accesses data it does not own or redistribute. The upstream data is © its provider and licensed separately from this tool's code. See DATA_LICENSE.md.

    BBK — official federal warnings are amtliche Werke (§ 5 Abs. 2 UrhG): may be redistributed unaltered with a source credit. Aggregates third-party sources (DWD, Länder flood portals) that carry their own terms.

    Dual-licensed — use it under either:

    • AGPL-3.0-or-later (default, free). Note the AGPL's §13 network clause: if you run a modified version as a network service, you must offer that modified source to the service's users.
    • Commercial license (paid), for closed-source / proprietary or SaaS use without the AGPL's obligations.

    See LICENSING.md for details, and CONTRIBUTING.md for the contribution policy (this project does not accept external code contributions). Commercial enquiries: sebs@2xs.org.

    Settings
    Member Visibility

    On This Page
    nina-warnungen-cli