Commands

Every command, argument and option of nina 0.6.1, read from the CLI itself.

Global options

These options work with every command.

OptionDescriptionDefault
-V, --version output the version number
--base-url <url> API base URL https://warnung.bund.de
--timeout <ms> per-request timeout in milliseconds (0 disables; waits indefinitely)
--user-agent <ua> User-Agent header value (non-blank; no control characters, Latin-1 only)
--max-retries <n> retries for transient 429/503 responses and reset connections (0..10, default 2; a linear backoff from 200 ms, or the server's Retry-After when longer, up to 30 s)
--max-response-bytes <n> cap response body size in bytes (0 = unlimited; default 100 MiB)
--log-format <format> how errors, warnings and notes are written to stderr: text (log4j style: time, level, [topic], message) or jsonl (one JSON object per line: ts, level, topic, msg); default text
--compact print JSON on a single line instead of pretty-printed
-o, --output <file> write the command's output to this file instead of stdout ("-" means stdout)

nina sources

List the valid warning sources

nina sources [options]

nina map-data

Current warnings from a source (mowas | katwarn | biwapp | dwd | lhp | police)

nina map-data [options] <source>

Arguments

<source> required

nina warning

A single warning by identifier

nina warning get

Get the full CAP warning for an identifier

nina warning get [options] <identifier>

Arguments

<identifier> required

nina warning geojson

Download the warning's geometry as GeoJSON (-o to write a file)

nina warning geojson [options] <identifier>

Arguments

<identifier> required

nina dashboard

Warnings affecting a district, by its district-level ARS (12 digits, last 7 digits 0; not a state key such as 050000000000, which the API answers with [])

nina dashboard [options] <ars>

Arguments

<ars> required

nina archive

MoWaS archive (historical warnings)

nina archive mapping

Revision history for an archived MoWaS identifier

nina archive mapping [options] <identifier>

Arguments

<identifier> required

nina archive get

A specific archived MoWaS warning, by a revision identifier from `archive mapping` (its .json suffix is optional)

nina archive get [options] <identifier>

Arguments

<identifier> required