by pulb

pulb / mailnag

An extensible mail notification daemon

210 Stars 25 Forks Last release: 7 months ago (v2.0.0) GNU General Public License v2.0 767 Commits 19 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


An extensible mail notification daemon

Mailnag is a daemon program that checks POP3 and IMAP servers for new mail.
On mail arrival it performs various actions provided by plugins.
Mailnag comes with a set of desktop-independent default plugins for
visual/sound notifications, script execution etc. and can be extended
with additional plugins easily.

This project needs your support!
If you like Mailnag, please help to keep it going by contributing code,
reporting/fixing bugs, translating strings into your native language,
writing docs or by making a donation.

PayPal — The safer, easier way to pay online.



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.

sudo apt-get install mailnag
in a terminal to install it.


Mailnag is available in Debian stable and unstable.

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 official repos.
Please run

pacman -Syu mailnag
(as root) to install the package.


Mailnag is available in openSUSE Tumbleweed.

sudo zypper install mailnag
in a terminal to install it.

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.
  • python (>= 3.5)
  • pygobject
  • gir-notify (>= 0.7.6)
  • gir-gtk-3.0
  • gir-gdkpixbuf-2.0
  • gir-glib-2.0
  • gir-gst-plugins-base-1.0
  • python-dbus
  • pyxdg
  • gettext
  • gir1.2-secret-1 (optional)
  • networkmanager (optional)



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

GNOME Control Center -> Details -> 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.

Desktop Integration

By default, Mailnag emits libnotify notifications, which work fine on most desktop environments
but are visible for a few seconds only. If you like to have a tighter desktop integration
(e.g. a permanently visible indicator in your top panel) you have to install an appropriate
extension/plugin for your desktop shell. Currently the following desktop shells are supported:
* GNOME-Shell (GNOME-Shell extension)
* KDE (Plasma 5 applet by driglu4it)
* Cinnamon (Applet by hyOzd)
* Elementary Pantheon (MessagingMenu plugin)
* XFCE (MessagingMenu plugin)

Furthermore, I highly recommend GNOME users to install the GOA plugin,
which makes Mailnag aware of email accounts specified in GNOME Online Accounts.


Gmail doesn't work
If Mailnag is unable to connect to your Gmail account, please try the following solutions: * Install the GOA plugin to connect via GNOME online accounts * Have a look at the FAQ * Try to apply this workaround

Other issues
If Mailnag doesn't work properly for you, either examine the system log for errors (

journalctl -b _COMM=mailnag
) or run
in a terminal and observe the output.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.