awesomewm-mirrors
/
awesome-wm-widgets
mirror of https://github.com/streetturtle/awesome-wm-widgets.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
awesome-wm-widgets/email-widget
History
Little Clover 2cac9f39d1 grammar correction 2021-12-13 17:36:10 +08:00
..
README.md grammar correction 2021-12-13 17:36:10 +08:00
count_unread_emails.py fix email widget script 2019-02-04 20:10:00 -05:00
em-wid-1.png screenshots and readme 2017-02-01 21:25:25 -05:00
em-wid-2.png screenshots and readme 2017-02-01 21:25:25 -05:00
email.lua bug(email_widget): Fix widgets not accessible 2021-05-10 20:21:04 +02:00
read_unread_emails.py Update read_unread_emails.py 2020-11-14 21:30:10 -06:00

README.md

Email widget

This widget consists of an icon with counter which shows number of unread emails: email icon and a popup message which appears when mouse hovers over an icon: email popup

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

Installation

To install it put email.lua and email-widget folder under ~/.config/awesome. Then

  • in email.lua change path to python scripts;
  • in python scripts add your credentials (note that password should be encrypted using pgp for example);
  • add widget to awesome:
local email_widget, email_icon = require("email")

...
s.mytasklist, -- Middle widget
	{ -- Right widgets
    	layout = wibox.layout.fixed.horizontal,
		...
		email_icon,
        email_widget,
		...

How it works

This widget uses the output of two python scripts, first is called every 20 seconds - 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:

python ~/.config/awesome/email/count_unread_emails.py 
python ~/.config/awesome/email/read_emails.py