powerline-owmweather 🌦

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).

• Motivation
• Requirements
• Installation
• Activation
• Configuration and Customization
• Changelog
• TODO

Motivation

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.

Requirements

• Powerline
• A (free) OpenWeather account and API key with the "Current Weather Data" plan enabled.

Installation

pip install powerline-owmweather

Activation

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
   }
}

Alternatively, the API key can also be provided by setting it as an environment variable, see Configuration and Customization for details.

and the following to your colorscheme JSON (the colors can be customized):

"groups": {
      ...,
      "owmweather": {
          "fg": "gray9",
          "bg": "gray2",
          "attrs": []
    }
}

Configuration and Customization

The following optional args are available:

Highlight Groups

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.

Changelog

0.5 - Dec. 27 2024

• Allowing to set openweathermap API key as an environment variable

0.4 - Nov. 3 2020

• '%' is no longer in the default humidity_format
• Added pre_data and post_data arguments and highlight groups
• Added ability to show location

0.3 - Nov. 1 2020

• Added ability to display humidity

0.2 - Nov. 1 2020

• Added ability to display temperature, condition
• Added ability to display condition as either icons or strings

0.1.1 - Oct. 31 2020

• Fixed a bug that prevented setting a custom ttl_in_minutes
• Added debug logs

0.1.0 - Oct. 31 2020

Initial release

TODO

• Support icons
• Support weather description ("cloudy", "windy", etc)
• Support configurable information to display:
  • Temperature
  • Condition
  • Wind speed/direction
  • Humidity
  • Pressure