kmi-cli#

CLI for KMI/IRM - Belgian weather data from the Royal Meteorological Institute.

Quick Start#

bash

# Current weather
kmi current Brussels

# 7-day forecast
kmi forecast Leuven

# Weather warnings
kmi warnings Belgium

# UV index
kmi uv Antwerp

No Authentication Required#

This CLI uses the public meteo.be API. No API key or registration needed.

Core Rules#

1. Always use --json when parsing output programmatically
2. Location formats: city name ( Brussels), coordinates ( 50.85,4.35), or favorite ( @home)
3. Use favorites with @prefix - e.g., kmi forecast @home
4. Rate limiting is automatic - CLI handles this transparently

Output Formats#

FlagFormatUse case(default)TableUser-facing display--jsonJSONAgent parsing, scripting--plainTSVPipe to awk/cut

Workflows#

Current Weather#

bash

# By city name
kmi current Brussels

# By coordinates
kmi current 50.85,4.35

# By saved favorite
kmi current @home

# JSON output for parsing
kmi current Brussels --json

Forecast#

bash

# 7-day forecast
kmi forecast Leuven

# Daily breakdown
kmi daily Leuven

# Hourly for next 12 hours
kmi hourly Leuven

# JSON output
kmi forecast Leuven --json

Radar#

bash

# Download radar animation frames
kmi radar Brussels

# Specify output directory
kmi radar Brussels --output-dir ~/tmp

Note: Radar downloads image files to the current or specified directory.

Warnings#

bash

# Get active weather warnings
kmi warnings Belgium

# JSON for scripting
kmi warnings Belgium --json

UV Index#

bash

# UV index for location
kmi uv Antwerp

# JSON output
kmi uv Antwerp --json

Favorites#

bash

# Save a favorite location
kmi favorites add home 50.85,4.35
kmi favorites add work Brussels

# List all favorites
kmi favorites list

# Use favorites with @ prefix
kmi forecast @home
kmi current @work

# Remove a favorite
kmi favorites remove work

Scripting Examples#

bash

# Get current temperature
kmi current Brussels --json | jq -r '.temperature'

# Check if rain is expected today
kmi forecast Brussels --json | jq -r '.[0].precipitation'

# Get warning count
kmi warnings Belgium --json | jq 'length'

# List all forecasted conditions
kmi forecast Brussels --json | jq -r '.[] | "\(.day): \(.condition)"'

Environment Variables#

VariableDescriptionKMI_LANGLanguage (en, nl, fr, de)NO_COLORDisable colored output

Guidelines#

• No API key needed - works out of the box
• Favorites require user setup - do not create favorites without user consent
• Rate limiting is handled automatically - no special handling needed
• Radar command downloads files - inform user about file output

Installation#

bash

# macOS/Linux
brew install dedene/tap/kmi

# Windows - download from GitHub Releases
# https://github.com/dedene/kmi-irm-cli/releases