A light-hearted Powerline segment for fetching and showing the weather in the current location (either by IP geolocation or by setting a location, see Configuration below).
Keep in mind that powerline_owmweather is in early, rapid development stage so its API/configuration format may change.
The built-in weather segment is using Yahoo Weather API which is no longer available so I decided to create an almost drop-in replacement using OpenWeather.
- Powerline
- A (free) OpenWeather account and API key with the "Current Weather Data" plan enabled.
pip install powerline-owmweather
The very minimum required to activate the segment is to add the following to your theme JSON:
{
"function": "powerline_owmweather.weather",
"args": {
"openweathermap_api_key": API_KEY
}
}
and the following to your colorscheme JSON (the colors can be customized):
"groups": {
...,
"owmweather": {
"fg": "gray9",
"bg": "gray2",
"attrs": []
}
}
The following optional args
are available:
Argument | Type | Description | Default |
---|---|---|---|
condition_as_icon |
boolean | If true , condition will be displayed as an icon (if one of known conditions).If false condition will be displayed as a string |
true |
humidity_format |
string | A Python format string that accepts humidity as an argument |
"{humidity:.0f}" |
location_query |
string | Location in format CITY, 2-LETTERS-COUNTRY-CODE | Retrived using IP geolocation |
post_condition |
string | String to append after condition |
"" |
post_humidity |
string | String to append after humidity |
"" |
post_location |
string | String to append after location |
"" |
post_temp |
string | String to append after temp |
"" |
pre_condition |
string | String to prepend before condition |
" " |
pre_humidity |
string | String to prepend before humidity |
" " |
pre_location |
string | String to prepend before location |
" " |
pre_temp |
string | String to prepend before temp |
" " |
show |
string | Comma-separated string specifies what data to show. Can include "condition" , "humidity" , "location" , "temp" .See Highlight Groups |
"temp" |
temp_format |
string | A Python format string that accepts temp as an argument |
"{temp:.0f}" |
ttl_in_minutes |
integer | Time in minutes for which location and weather are cached. Warning: The lower the value the slower your terminal will be |
60 |
units |
string | Temperature units. Should be one of "C" , "F" , "K" |
"C" |
Every data in "show"
is displayed in its own segment with its own highlight group, meaning it can be styled independently in your colorscheme JSON. Each highlight group is composed of owmweather_{data_name}
, for example:
"owmweather_condition": {
"fg": "gray6",
"bg": "gray3",
"attrs": []
},
"owmweather_temp": {
"fg": "gray9",
"bg": "gray2",
"attrs": []
}
"pre_{data_name}"
and "post_{data_name}"
can also be customized using "owmweather_pre_{data_name}"
and "owmweather_post_{data_name}"
highlight groups.
If a specific highlight group is not defined then the style of "owmweather"
group will be used.
'%'
is no longer in the defaulthumidity_format
- Added
pre_data
andpost_data
arguments and highlight groups - Added ability to show location
- Added ability to display humidity
- Added ability to display temperature, condition
- Added ability to display condition as either icons or strings
- Fixed a bug that prevented setting a custom
ttl_in_minutes
- Added debug logs
Initial release
- Support icons
- Support weather description ("cloudy", "windy", etc)
- Support configurable information to display:
- Temperature
- Condition
- Wind speed/direction
- Humidity
- Pressure