AnsiWeather is a Shell script for displaying the current weather conditions in your terminal, with support for ANSI colors and Unicode symbols.
Weather data comes from the OpenWeatherMap free weather API.
AnsiWeather requires the following dependencies :
- A command to fetch HTTP data such as FTP, cURL or wget
- jq (lightweight and flexible command-line JSON processor)
- bc (arbitrary precision numeric processing language), for doing float arithmetic
After cloning the repository, simply invoke the script by typing :
./ansiweather
AnsiWeather packages are available for :
pkg_add ansiweather
pkgin install ansiweather
pkg install ansiweather
apt-get install ansiweather
brew install ansiweather
ansiweather [options]
Options are :
-l Specify location
-u Specify unit system to use (metric or imperial)
-f Toggle forecast mode for the specified number of upcoming days
-F Toggle forecast mode for the next five days
-d Toggle daylight data display
-a Toggle ANSI colors display
-s Toggle symbols display
-k OpenWeatherMap API key
-h Display usage
Any configuration options may also be passed in as command line options :
ansiweather -l Rzeszow,PL -u metric -s true -f 5 -d true
The default config file is ~/.ansiweatherrc. The environment variable ANSIWEATHERRC can be set to override this. The following configuration options (detailed below) are available and should be set according to your location and preferences.
Example : ~/.ansiweatherrc
location:Rzeszow,PL
fetch_cmd:ftp -V -o -
units:metric
daylight:true
The file ansiweatherrc.example contains all available configuration variables.
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. Alternatively, it's also possible to specify locations by their ID, a city list is available here.
In case no location is specified, AnsiWeather will fallback to the default location.
Example : Rzeszow,PL
location:Rzeszow,PL
Various tools can be used to fetch data : curl, wget, ftp.
Please note that ftp flags and options might differ among implementations and versions, and the example provided here is known to work only on OpenBSD, NetBSD and Mac OS X.
Example : curl -sf
fetch_cmd:curl -sf
Example : wget -qO-
fetch_cmd:wget -qO-
Example : ftp -V -o -
fetch_cmd:ftp -V -o -
Default: curl -sf
Both metric and imperial systems are supported.
units:metric
Default: metric
Toggle ANSI sequences display. Value can be either true (requires an ANSI capable display) or false.
ansi:true
Default: true
Toggle Unicode symbols display. Value can be either true (requires an Unicode capable display) or false.
symbols:true
Default: true
Symbols can be configured or replaced by custom text using the following configuration variables : sun, moon, clouds, rain, fog, mist, haze, snow, thunderstorm.
Show upcoming forecast for the next N days (for 0 <= N <= 7). 0 will show standard output.
forecast:5
Default: 0
Toggle daylight display. Value can be either true or false.
daylight:false
Default: false
Configure date and time format display. See Unix date formatting documentation for details.
dateformat:%a %b %d
Default : %a %b %d
timeformat:%b %d %r
Default : %b %d %r
Specify an OpenWeatherMap API key. By default AnsiWeather uses its own key, but users can optionally get their own one by creating a free OpenWeatherMap account.
api_key:85a4e3c55b73909f42c6a23ec35b7147
AnsiWeather is released under the BSD 3-Clause license. See LICENSE file
for details.
AnsiWeather is developed by Frederic Cambus
- Site : http://www.cambus.net
- Twitter: http://twitter.com/fcambus