awesome-wm-widgets/weather-widget
Pavel Makhov 7403bdb0f6 gerrit widget 2019-09-22 22:44:50 -04:00
..
README.md [Weather] Add option to set the position of the notification 2019-09-18 01:31:26 +02:00
weather-widget.png update screenshot 2017-03-14 21:56:27 -04:00
weather.lua gerrit widget 2019-09-22 22:44:50 -04:00

README.md

Weather widget

Weather Widget

Note that widget uses the Arc icon theme, so it should be installed first under /usr/share/icons/Arc/ folder.

Customization

It is possible to customize widget by providing a table with all or some of the following config parameters:

Name Default Description
font Play 9 Font
city Montreal,ca City name and country code, more info
api_key none API key, required
units metric metric for celsius, imperial for fahrenheit
both_units_widget false show temperature in both units (15°C (59°F)) or in one (15°C)
both_units_popup false same as above but for popup
notification_position top_right The notification position

Example:

weather_widget({
    api_key = 'your-api-key',
    units = 'imperial',
    font = 'Ubuntu Mono 9'
}),

Installation

  1. Install lua socket - to make HTTP calls to get the weather information.

    $ sudo apt-get install lua-socket
    
  2. Download json parser for lua from github.com/rxi/json.lua and place it under ~/.config/awesome/ (don't forget to star a repo ):

    wget -P ~/.config/awesome/ https://raw.githubusercontent.com/rxi/json.lua/master/json.lua
    
  3. Clone this repo under ~/.config/awesome/:

    git clone https://github.com/streetturtle/awesome-wm-widgets.git ~/.config/awesome/
    
  4. Get Open Weather Map app id here: openweathermap.org/appid.

  5. Require weather widget at the beginning of rc.lua:

    local weather_widget = require("awesome-wm-widgets.weather-widget.weather")
    
  6. Add widget to the tasklist:

    s.mytasklist, -- Middle widget
        { -- Right widgets
            layout = wibox.layout.fixed.horizontal,
            ...
            --default
            weather_widget({api_key = 'your-api-key'}),
            --customized
            weather_widget({
                api_key = 'your-api-key',
                units = 'imperial',
                font = 'Ubuntu Mono 9'
            })
            ...
    

You can read how it works in more details here