diff options
| author | streetturtle <streetturtle@gmail.com> | 2015-12-25 23:36:30 +0100 |
|---|---|---|
| committer | streetturtle <streetturtle@gmail.com> | 2015-12-25 23:36:30 +0100 |
| commit | 1b955adc11aad97d3eb9d49a15323516c94a333d (patch) | |
| tree | c0c9bc561b5801d5a83379ba0d2001f71cc043ab | |
| parent | 68c48c0a73bf1b6cba17d7ee7db8088bd28c5ec7 (diff) | |
readme for email widget
| -rw-r--r-- | BatteryWidget/batWid3.png | bin | 8284 -> 8484 bytes | |||
| -rw-r--r-- | EmailWidget/README.md | 26 |
2 files changed, 26 insertions, 0 deletions
diff --git a/BatteryWidget/batWid3.png b/BatteryWidget/batWid3.png Binary files differindex feeb453..67d5fd4 100644 --- a/BatteryWidget/batWid3.png +++ b/BatteryWidget/batWid3.png diff --git a/EmailWidget/README.md b/EmailWidget/README.md new file mode 100644 index 0000000..729b88f --- /dev/null +++ b/EmailWidget/README.md @@ -0,0 +1,26 @@ +This widget consists of an icon with counter which shows number of unread emails:  +and a popup message which appears when mouse hovers over an icon:  + +## Installation + +To install it either clone [EmailWidget](https://github.com/streetturtle/AwesomeWM/tree/master/EmailWidget) project under `~/.config/awesome/` or download a .zip archive and unzip it there. + +After provide your credentials in python scripts so that they could connect to server and add following lines in your **rc.lua** file: + +{% highlight lua %} +require("email") +... +right_layout:add(emailWidget_icon) +right_layout:add(emailWidget_counter) +{% endhighlight lua %} + +## How it works + +This widget uses the output of two python scripts, first is called every 5 minutes - it returns number of unread emails and second is called when mouse hovers over an icon and displays content of those emails. For both of them you'll need to provide your credentials and imap server. For testing they can simply be called from console: + +{% highlight bash %} +python ~/.config/awesome/email/countUnreadEmails.py +python ~/.config/awesome/email/readEmails.py +{% endhighlight bash %} + +Note that getting number of unread emails could take some time, so instead of `pread` or `spawn_with_shell` functions I use DBus, you can read more about it in [this]({{site.url}}/2015/09/fix-awesome-freezes) post. |
