Weathr terminal app shows real-time weather with animated ASCII art

Weathr is a terminal weather app with ASCII animations

A new command-line tool called weathr displays real-time weather with animated ASCII art. The app pulls data from the Open-Meteo API and renders conditions like rain, snow, and thunderstorms directly in your terminal.

It includes animations for flying airplanes, falling leaves, and a day/night cycle. The tool can auto-detect your location via IP address or use manually set coordinates.

How to install the app

You can install weathr in several ways. The primary method is via Rust's Cargo package manager.

• cargo install weathr
• Build from source with git clone and cargo install --path .
• Arch Linux users can install weathr-bin from the AUR.
• NixOS users can add it as a flake input.

Configuring your location and units

The app uses a TOML configuration file. Its default location depends on your operating system.

You can place a config.toml in your current working directory, which takes priority. The config lets you set coordinates, toggle auto-location, and choose display units.

Key settings include hiding the weather details HUD, running silently, and specifying units for temperature, wind speed, and precipitation.

Using the command line

Run the app with weathr for real-time weather. It includes several command-line flags for simulation and control.

You can simulate specific conditions for testing, such as weathr --simulate rain or weathr --simulate snow --night. Other flags let you switch between imperial and metric units, toggle auto-location, and hide UI elements.

Available keyboard controls let you quit the app with q or Ctrl+C.

Privacy and data sources

When auto-location is enabled, the app makes a single request to ipinfo.io to approximate your location from your IP address. This is optional.

You can disable this feature and manually set your latitude and longitude in the config file to avoid any external API calls besides Open-Meteo. Weather data is provided by Open-Meteo under a Creative Commons license.

The ASCII art is sourced from credited artists, including Joan G. Stark and Hayley Jane Wakenshaw. The app is licensed under the GPL-3.0-or-later license.