In Operation
There’s a bit of post-installation configuration recommended but not essential.
You’ll need an OpenWeather API key if you’re going to use girouette on a regular basis. The project provides a default key but it’s rate-limited. Your own free API key gives you 60 calls to the API per minute and 1 million calls per month. You can specify your key using the -k option, but it's best placed in the program's config.yml file.
The project provides 4 example config files (classic.yml, forecast.yml, monokai_nerd_fonts.yml, solarized_dark.yml in the GitHub repository. The config file needs to be named config.yml and saved to ~/girouette/config.yml or ~/.config/girouette/config.yml.
You can override elements of the config file with command-line options. For example, if you want to get weather information for a different location to that specified in your config file, use the -l option. This can be a location name such as 'London, UK', 'Paris', or you can specify geographic coordinates (latitude, longitude such as ‘40.71,74.00’
Here's an image of girouette in action using the forecast.yml config.
You can also change the units when showing temperatures and speeds. By default, girouette displays temperatures and wind speeds in Celsius and km/h. But you can change this to show imperial measurements (Fahrenheit temperatures and miles/hour speeds) or standard (Kelvin temperatures and meters/second speeds).
Summary
girouette is a useful command-line tool but faces stiff competition from Wego.
The software is highly customizable. can display alerts showing weather alerts for the current location. It can also show the current Air Quality Index, the current cloud cover, as well as a daytime segment to display sunrise and sunset times for the current day.
The daily_forecast segment can show the temperature and general weather for the next 1 to 7 days, and an hourly_forecast segment shows the temperature and general weather for each hour in the next 48 hours (defaults to 3).
Website: github.com/gourlaysama/girouette
Support:
Developer: Antoine Gourlay
License: Apache License 2.0 or MIT License
girouette is written in Rust. Learn Rust with our recommended free books and free tutorials
Pages in this article:
Page 1 - Introduction and Installation
Page 2 - In Operation and Summary