{"id":13557794,"url":"https://github.com/pulb/mailnag","last_synced_at":"2025-12-18T12:11:03.777Z","repository":{"id":1556553,"uuid":"1952265","full_name":"pulb/mailnag","owner":"pulb","description":"An extensible mail notification daemon","archived":false,"fork":false,"pushed_at":"2024-07-18T11:49:44.000Z","size":2434,"stargazers_count":254,"open_issues_count":86,"forks_count":32,"subscribers_count":14,"default_branch":"master","last_synced_at":"2024-11-04T08:36:22.067Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pulb.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2011-06-25T14:17:47.000Z","updated_at":"2024-10-15T03:33:02.000Z","dependencies_parsed_at":"2024-11-04T08:31:30.176Z","dependency_job_id":"041a6874-130f-4b18-a823-16c67ac2509e","html_url":"https://github.com/pulb/mailnag","commit_stats":{"total_commits":765,"total_committers":17,"mean_commits":45.0,"dds":"0.10326797385620912","last_synced_commit":"7ef91050cf3ccea2eeca13aefdbac29716806487"},"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pulb%2Fmailnag","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pulb%2Fmailnag/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pulb%2Fmailnag/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pulb%2Fmailnag/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pulb","download_url":"https://codeload.github.com/pulb/mailnag/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247002231,"owners_count":20867431,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T12:04:33.086Z","updated_at":"2025-12-18T12:10:58.710Z","avatar_url":"https://github.com/pulb.png","language":"Python","funding_links":["https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=8F5FNJ3U4N7AW"],"categories":["Python","Applications","others"],"sub_categories":["Email"],"readme":"![Screenshot](https://raw.githubusercontent.com/pulb/mailnag-design/master/Flyer/Mailnag_flyer2.png)\n\n## An extensible mail notification daemon\n\nMailnag is a daemon program that checks POP3 and IMAP servers for new mail.  \nOn mail arrival it performs various actions provided by plugins.  \nMailnag comes with a set of desktop-independent default plugins for  \nvisual/sound notifications, script execution etc. and can be extended  \nwith additional plugins easily.\n\n__This project needs your support!__  \nIf you like Mailnag, please help to keep it going by [contributing code](https://github.com/pulb/mailnag),  \n[reporting/fixing bugs](https://github.com/pulb/mailnag/issues), [translating strings into your native language](https://hosted.weblate.org/projects/mailnag/mailnag/),  \n[writing docs](https://github.com/pulb/mailnag/wiki) or by [making a donation](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=8F5FNJ3U4N7AW).  \n\n\u003ca href=\"https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=8F5FNJ3U4N7AW\" target=\"_blank\"\u003e\n\u003cimg src=\"https://www.paypalobjects.com/en_US/GB/i/btn/btn_donateCC_LG.gif\" alt=\"PayPal — The safer, easier way to pay online.\"/\u003e\u003c/a\u003e\n\n## Installation\n\n### Ubuntu\nMailnag has an official [Ubuntu PPA](https://launchpad.net/~pulb/+archive/mailnag).  \nIssue the following commands in a terminal to enable the PPA and install Mailnag.  \n\n    sudo add-apt-repository ppa:pulb/mailnag\n    sudo apt-get update\n    sudo apt-get install mailnag\n\nAs of Ubuntu 13.04 (Raring), Mailnag is also available in the official repos.  \nRun `sudo apt-get install mailnag` in a terminal to install it.\n\n### Debian\nMailnag is available in Debian stable and unstable.  \nRun `sudo apt-get install mailnag` in a terminal to install it.\n\n### Fedora\nAs of Fedora 17, Mailnag is available in the official Fedora repos.  \nJust run `yum install mailnag` (as root) in a terminal to install the package.\n\n### Arch Linux\nMailnag is available in the official repos.  \nPlease run `pacman -Syu mailnag` (as root) to install the package.\n\n### openSUSE\nMailnag is available in openSUSE Tumbleweed.  \nRun `sudo zypper install mailnag` in a terminal to install it.\n\n### Generic Tarballs\nDistribution independent tarball releases are available [here](https://github.com/pulb/mailnag/releases).  \nJust run `./setup.py install` (as root) to install Mailnag,  \nthough make sure the requirements stated below are met.\n\n###### Requirements\n* python (\u003e= 3.5)\n* pygobject\n* gir-notify (\u003e= 0.7.6)\n* gir-gtk-3.0\n* gir-gdkpixbuf-2.0\n* gir-glib-2.0\n* gir-gst-plugins-base-1.0\n* python-dbus\n* pyxdg\n* gettext\n* gir1.2-secret-1 (optional)\n\n\n## Configuration\nRun `mailnag-config` to setup Mailnag.  \nClosing the configuration window will start Mailnag automatically.\n\n### Default Mail Client\nClicking a mail notification popup will open the default mail client specified in `GNOME Control Center -\u003e Details -\u003e Default Applications`.  \nIf 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](http://gnome-gmail.sourceforge.net).\n\n### Desktop Integration\nBy default, Mailnag emits libnotify notifications, which work fine on most desktop environments  \nbut are visible for a few seconds only. If you like to have a tighter desktop integration  \n(e.g. a permanently visible indicator in your top panel) you have to install an appropriate  \nextension/plugin for your desktop shell. Currently the following desktop shells are supported:  \n* GNOME-Shell ([GNOME-Shell extension](https://github.com/pulb/mailnag-gnome-shell))  \n* KDE ([Plasma 5 applet by driglu4it](https://store.kde.org/p/1420222/))  \n* Cinnamon ([Applet by hyOzd](https://bitbucket.org/hyOzd/mailnagapplet))  \n* Elementary Pantheon ([MessagingMenu plugin](https://github.com/pulb/mailnag-messagingmenu-plugin))  \n* XFCE ([MessagingMenu plugin](https://github.com/pulb/mailnag-messagingmenu-plugin))  \n  \nFurthermore, I highly recommend GNOME users to install the [GOA plugin](https://github.com/pulb/mailnag-goa-plugin),  \nwhich makes Mailnag aware of email accounts specified in GNOME Online Accounts.  \n\n### Troubleshooting\n\n__Gmail doesn't work__  \nIf Mailnag is unable to connect to your Gmail account, please try the following solutions:\n* Install the [GOA plugin](https://github.com/pulb/mailnag-goa-plugin) to connect via GNOME online accounts\n* Have a look at the [FAQ](https://github.com/pulb/mailnag/wiki/FAQ)\n* Try to apply [this](https://github.com/pulb/mailnag/issues/190) workaround\n\n__Other issues__  \nIf Mailnag doesn't work properly for you, either examine the system log for errors (`journalctl -b _COMM=mailnag`)\nor run `mailnag` in a terminal and observe the output.\n  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpulb%2Fmailnag","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpulb%2Fmailnag","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpulb%2Fmailnag/lists"}