Skip to content
This repository

A mail notification daemon for GNOME 3

branch: master


A mail notification daemon for GNOME 3.

Mailnag checks POP3 and IMAP servers for new mail.
When it finds new messsages, it creates a GNOME-Shell notification
that mentions sender and subject.

This project needs contributors!



Mailnag has an official Ubuntu PPA.
Issue the following commands in a terminal to enable the PPA and install Mailnag.

sudo add-apt-repository ppa:pulb/mailnag
sudo apt-get update
sudo apt-get install mailnag

As of Ubuntu 13.04 (Raring), Mailnag is also available in the official repos.
Run sudo apt-get install mailnag in a terminal to install it.


Mailnag is currently available in Debian unstable.
Run sudo apt-get install mailnag in a terminal to install it.


As of Fedora 17, Mailnag is available in the official Fedora repos.
Just run yum install mailnag (as root) in a terminal to install the package.

Arch Linux

Mailnag is available in the AUR repository.
You're an Arch user - you know what to do ;-)

Generic Tarballs

Distribution independent tarball releases are available here.
Just run ./ install (as root) to install Mailnag,
though make sure the requirements stated below are met.

  • python2 (python3 won't work!)
  • pygobject
  • gir-notify
  • gir-gstreamer
  • gir-glib-2.0
  • gir-gnomekeyring-1.0
  • python-httplib2
  • python-dbus
  • pyxdg
  • gettext


Run mailnag_config to setup Mailnag.
Closing the configuration window will start Mailnag automatically.

Default Mail Client

Clicking a mail notification popup will open the default mail client specified in System Settings -> System Info -> Default Applications.
If you're a webmail (e.g. gmail) user and want your account to be launched in a browser, please install a tool like gnome-gmail.

Permanent Notifications

GNOME-Shell notifications are visible for a few seconds only before they vanish in GNOME's hidden messaging tray.
If you like to have a permanently visible notification counter in your top panel, you probably want to install this GNOME-Shell extension.



Something went wrong with that request. Please try again.