UUID: gmail@lauritsriple
Last edited:
2 months ago 2019-04-29, 20:50 UTC
Last commit: [5a0e6b44] gmail@lauritsriple - update readme with better instructions for set up on Mint Cinnamon (#2419)

Shows most recent mails, and how many unread messages you have.




Should be working. Not completely finished. Only tested on arch linux.

Needed Python libaries

keyring,keyrings-alt,feedparser,urlparser (I think this is installed by default):. To install them you need pip for python3. Short install list:

sudo apt-get install pip3
sudo pip3 install feedparser
sudo pip3 install keyring
sudo pip3 install keyrings-alt

If you are using Cinnamon on Linux Mint you can install the required python libraries via apt

apt install python3-feedparser python3-keyring python3-keyrings.alt

Storage of username and password

Uses the system keyring service (gnome-keyring) to store and extract the password, so they are not stored in cleartext. You might have to install this. If you are using 2-step authentication for your google account you will need to create an app password to use in the applet at

Gmail atom feed

Uses the gmail atom feed to get info from gmail. You might have to enable access for less secure apps in gmail. Test in your browser if you have access with one of these links. or

Install from git

cd ~/.local/share/cinnamon/applets git clone gmail@lauritsriple Merged to

Install from spices

You can install this from spices. Just click availible applets (online) and serach for gmail. There is currently two applets with almost the same name so make sure you choose the one which has gmail@lauritsriple. I tried to get the other one to work, but i couldn't and i didn't like that it stored password in plain text.


  • [X] Add notifications when receiving new mail
  • [X] Lit panel icon on new mail
  • [ ] Move atom feedparser to pure js
  • [ ] Move credential storage to pure js
  • [ ] Configure storage of passord in settings-schema.json to hide password while typing

Log In To Comment!


Vlad-Ver-4 months ago
LM 19.1 Does not work! "Error from json parser"
Jan Helbling
Jan Helbling-1 year ago
LM 18.3: it Works! Thanks for this great applet!
rickrich-1 year ago
On Fedora 26 I get: ERROR: error from json parser feedparser, keyring, and keyrings-alt are installed. Username and password are correct.
Fedora Tux
Fedora Tux-1 year ago
On Fedora 26 27 never working
Lvaskz-1 year ago
Hi, i can not instal pip3, some error
Sergey-2 years ago
There is an error in "Needed Python libaries": sudo pip3 install keyrings correct is keyring
emilio rojas hernandez
no se como funciona probare