diff options
author | Pavel Makhov <pmakhov@touchtunes.com> | 2019-01-26 23:14:21 -0500 |
---|---|---|
committer | Pavel Makhov <pmakhov@touchtunes.com> | 2019-01-26 23:14:21 -0500 |
commit | bf96cfa3131cb5e3c762f5274663b83557dab981 (patch) | |
tree | 71f468a4034300484d34143e4d770d36d3e0927b | |
parent | 70fd5a38b0fcd9d1399d3d978f05d9964abb812c (diff) | |
parent | d767e3b8deda7d026090b50184fe5903a58b6103 (diff) |
Merge branch 'master' of https://github.com/streetturtle/awesome-wm-widgets
-rw-r--r-- | weather-widget/README.md | 44 |
1 files changed, 37 insertions, 7 deletions
diff --git a/weather-widget/README.md b/weather-widget/README.md index 7573cff..8ca7cee 100644 --- a/weather-widget/README.md +++ b/weather-widget/README.md @@ -1,17 +1,47 @@ # Weather widget -![Weather Widget](./weather-widget.png) +![Weather Widget]({{'/assets/img/screenshots/weather-widget.png' | relative_url }}){:.center-image} Note that widget uses the Arc icon theme, so it should be [installed](https://github.com/horst3180/arc-icon-theme#installation) first under **/usr/share/icons/Arc/** folder. ## Installation - - install lua socket -```bash -$ sudo apt-get install lua-socket -``` +1. Install lua socket - to make HTTP calls to get the weather information. + + ```bash + $ sudo apt-get install lua-socket + ``` + +1. Download json parser for lua from [github.com/rxi/json.lua](https://github.com/rxi/json.lua) and place it under **~/.config/awesome/** (don't forget to star a repo <i class="fa fa-github-alt"></i> ): + + ```bash + wget -P ~/.config/awesome/ https://raw.githubusercontent.com/rxi/json.lua/master/json.lua + ``` + +1. Clone this repo under **~/.config/awesome/**: + + ```bash + git clone https://github.com/streetturtle/awesome-wm-widgets.git ~/.config/awesome/ + ``` + +1. Get Open Weather Map app id here: [openweathermap.org/appid](https://openweathermap.org/appid) and place it in **~/.config/awesome/awesome-wm-widgets/secrets.lua**, or directly in the widget. Don't forget to set also your city. + +1. Require weather widget at the beginning of **rc.lua**: + + ```lua + local weather_widget = require("awesome-wm-widgets.weather-widget.weather") + ``` + +1. Add widget to the tasklist: + + ```lua + s.mytasklist, -- Middle widget + { -- Right widgets + layout = wibox.layout.fixed.horizontal, + ... + weather_widget, + ... + ``` - - download json parser for lua: https://github.com/rxi/json.lua - - get Open Weather Map app id here: https://openweathermap.org/appid You can read how it works in more details [here](http://pavelmakhov.com/2017/02/weather-widget-for-awesome-wm) |