GitHub - Tairesh/rustormy: 🌦️ Minimal neofetch-like weather CLI

https://github.com/Tairesh/rustormy • Aug 26, 2025 22:51

Extracto

🌦️ Minimal neofetch-like weather CLI. Contribute to Tairesh/rustormy development by creating an account on GitHub.

Contenido

rustormy

Minimal and neofetch-like weather CLI inspired by stormy and rainy, written in 🦀 Rust

Current features

Fetch weather data from OpenMeteo (no API key required) or OpenWeatherMap
Display current temperature, weather condition, wind speed and direction, humidity. precipitation, atmospheric pressure.
Display ASCII art icons for weather conditions
ANSI colors in terminal output
Supports city name or latitude/longitude input
Supports multiple languages (English, Russian, Spanish; more to come)
Supports imperial and metric units
Supports JSON output
Live mode (periodically fetch and display updated weather data)

Planned features

Support for more weather APIs
More detailed weather information (e.g. dew point, UV index, etc.)
More customization options (e.g. colors, layout, etc.)

Installation

You can install rustormy using cargo:

Or download a precompiled binary from the releases page.

Configuration

rustormy uses XDG Base Directory Specification for configuration files and will create a configuration file at ~/.config/rustormy/config.toml to set default options at first run.

On macOS, the configuration file will be located at $HOME/Library/Application Support/rustormy/config.toml.

On Windows, the configuration file will be located at %APPDATA%\Roaming\rustormy\config.toml.

Configuration options

# Default city name (if not provided via CLI)
city = "New York"
# Default latitude (if not provided via CLI)
lat = 40.7128
# Default longitude (if not provided via CLI)
lon = -74.0060
# Weather data provider (`open_meteo` or `open_weather_map`)
provider = "open_meteo"
# API key for OpenWeatherMap (required if provider is `open_weather_map`)
api_key = ""
# Default units for temperature and wind speed (`metric` or `imperial`)
units = "metric"
# Default output format (`text` or `json`)
output_format = "text"
# Language for weather description (e.g. "en" for English, "ru" for Russian, "es" for Spanish, etc.)
language = "en"
# Show city name in output
show_city_name = true
# Use colors in output
use_colors = true
# Live mode (periodically fetch and display updated weather data)
live_mode = false
# Live mode interval in seconds
live_mode_interval = 300

Usage

rustormy [OPTIONS]

Options:
  -c, --city <CITY>
          City name (required if lat/lon not provided)
  -y, --lat <LAT>
          Latitude (required if city not provided)
  -x, --lon <LON>
          Longitude (required if city not provided)
  -p, --provider <PROVIDER>
          Weather data provider [possible values: open_meteo, open_weather_map]
  -u, --units <UNITS>
          Units for temperature and wind speed [possible values: metric, imperial]
  -o, --output-format <OUTPUT_FORMAT>
          Output format [possible values: text, json]
  -g, --language <LANGUAGE>
          Language for weather output [possible values: en, ru, es]
      --show-city-name
          Show city name in output
      --use-colors
          Use colors in output
  -l, --live-mode
          Live mode - continuously update weather data every 5 minutes (or specified interval)
  -i, --live-mode-interval <LIVE_MODE_INTERVAL>
          Live mode update interval in seconds (default: 300)
  -h, --help
          Print help
  -V, --version
          Print version

Examples

License

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

Contributing

Contributions are welcome! Please open an issue or submit a pull request on GitHub.