Skip to content

Weather in terminal, with ANSI colors and Unicode symbols.

License

Notifications You must be signed in to change notification settings

dimartz/weather

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

weather

Description

weather is a CLI for displaying the current weather conditions in your terminal, with support for ANSI colors and Unicode symbols.

wtr_def_sc

weather data comes from the OpenWeatherMap free weather API.

Requirements

weather requires the following dependencies:

  • cURL
  • Cargo
  • Nerd Fonts
  • JoyPixels (or any other emoji source)

Installation

The following is step-by-step instruction.

$ git clone https://github.com/dimartz/weather.git
$ cargo install --path weather/

Move the binary file ~/.cargo/bin/weather to the path of your choice.

Uninstall

If the binary remains on the original path:

$ cargo uninstall weather

Usage

Synopsis

weather [-l location] [-I imperial system] [-F extended forecast]
        [-h humidity] [-w wind] [-d daylight] [- only weather]
        [-H help] [-V version]

Options

-l="[LOCATION]"
(use quotes)		Specify location.
			Default: auto localization.

-I
			Toggle unit system to Imperial.
			Default: Metric.

-F
			Toggle extended forecast mode.

-h
			Show humidity data display.

-w
			Show wind data display.
	
-d
			Show daylight data display.
	
-
(dash symbol)		Show only weather display.

-H, --help
			Display usage information.
	
-V, --version
			Display version

Examples

Display weather using imperial units for Gold Coast, Australia:

weather -l="Gold Coast,AU" -I

wtr_example_sc

Location

Location format is city,CC where CC is a two-letter ISO 3166-1 alpha-2 country code. A list of country codes is available here.

Example: "Copenhagen,DK"

In case no location is specified, weather will auto-detect your location with ip-api.

System of Units

Both metric and imperial systems are supported. metric is the default unit. To switch to imperial:

weather -I -

wtr_imp_sc

Display forecast

Show upcoming forecast for the next days.

weather -F

wtr_ext_sc

Date and Time format

weather uses the format provided by date according to your system settings.

License

weather is released under the BSD 2-Clause license. See LICENSE file for details.

Resources

GitHub: https://github.com/dimartz/weather

GitHub: https://github.com/fcambus/ansiweather

About

Weather in terminal, with ANSI colors and Unicode symbols.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 100.0%