{ "info": { "author": "Micha\u0142 Krzywkowski", "author_email": "k.michal@zoho.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: End Users/Desktop", "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3 :: Only", "Topic :: Communications :: Email", "Topic :: Internet" ], "description": ".. image:: https://badge.fury.io/py/maildirwatch.svg\n :target: https://badge.fury.io/py/maildirwatch\n\n=====================================================================\n maildirwatch - Watch Maildir for new mail and display notifications\n=====================================================================\n\nThe program scans a single directory recursively, looking for Maildirs_. When\na Maildir is found, the program starts watching it for new email messages.\nWhen email messages arrive to the ``new`` directory, a notification is\ndisplayed with GTK. The directory to scan can be set in a configuration file,\nand it defaults to ``~/Maildir``.\n\nA separate notification is **not** displayed for each email message that\narrives. Instead, a single notification is displayed for a bunch of new\nmessages.\n\nThe displayed notification is interactive - actions can be performed when user\nclicks on the notification. By default, no actions are defined. Actions can\nbe defined in the configuration file.\n\nInstallation\n============\n\nInstallation from PyPI_::\n\n pip3 install --user maildirwatch\n\nPython3 is required.\n\n**Note**: PyGObject_ is a dependency of this program. To successfully install it,\nyou might have to install GObject development libraries on your system. On\nDebian, the package ``libgirepository1.0-dev`` might have to be installed.\n\nUsage\n=====\n\nUse the ``maildirwatch`` command to start the program, or::\n\n python3 -m maildirwatch\n\nTo list available options, run::\n\n maildirwatch --help\n\nConfiguration\n=============\n\nThe program looks for the configuration file in\n``$XDG_CONFIG_HOME/maildirwatch.conf`` or ``~/.config/maildirwatch.conf`` if\n``XDG_CONFIG_HOME`` is not defined.\n\nThe configuration file is in Python's standard config format (understood by the\n``configparser`` module).\n\nGlobal options\n--------------\n\nThese options should be put in the ``[global]`` section.\n\n* ``maildir``\n\n The directory to scan for maildirs. Default value: ``~/Maildir``.\n\n* ``ignore``\n\n Comma-separated list of maildir patterns to ignore. Each pattern must be in\n fnmatch_ style. By default, no maildirs are ignored.\n\nActions\n-------\n\nEach action is a path to a program (and an optional list of arguments). Every\naction also has a unique name that is displayed to the user. When an action\nwithin a notification is clicked on, the action program is started.\n\nAction definitions must be put in ``[actions]`` section. Actions are defined\nlike this::\n\n action name = /path/to/program arg1 arg2 arg3...\n\nAction names can contain spaces.\n\nOne action name is special - the ``default`` action. The default action's\nvalue should be the name of another action instead of path to a program. The\ndefault action is invoked when the user clicks on the notification itself, not\nany other action.\n\nExample configuration\n---------------------\n\nHere is an example configuration file that modifies path to the Maildir,\nignores spam folder and defines two actions::\n\n [global]\n maildir = ~/mail\n ignore = *Spam,*foo/bar*\n\n [actions]\n default = Show mu4e\n Show mu4e = emacs -f mu4e\n Start thunderbird = thunderbird\n\n\nLicense\n=======\n\n::\n\n Copyright (C) 2019 Micha\u0142 Krzywkowski\n\n This program is free software: you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation, either version 3 of the License, or\n (at your option) any later version.\n\n This program is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n GNU General Public License for more details.\n\n You should have received a copy of the GNU General Public License\n along with this program. If not, see .\n\n.. _Maildirs: https://cr.yp.to/proto/maildir.html\n.. _PyPI: https://pypi.org/\n.. _PyGObject: https://pypi.org/project/PyGObject/\n.. _fnmatch: https://docs.python.org/3/library/fnmatch.html\n..\n\n Local Variables:\n coding: utf-8\n fill-column: 79\n End:\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "https://github.com/mkcms/maildirwatch/archive/v0.1.0.tar.gz", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/mkcms/maildirwatch", "keywords": "", "license": "GPLv3", "maintainer": "", "maintainer_email": "", "name": "maildirwatch", "package_url": "https://pypi.org/project/maildirwatch/", "platform": "", "project_url": "https://pypi.org/project/maildirwatch/", "project_urls": { "Download": "https://github.com/mkcms/maildirwatch/archive/v0.1.0.tar.gz", "Homepage": "https://github.com/mkcms/maildirwatch" }, "release_url": "https://pypi.org/project/maildirwatch/0.1.0/", "requires_dist": [ "PyGObject" ], "requires_python": "", "summary": "Watch Maildir for incoming mail and display notifications", "version": "0.1.0" }, "last_serial": 4994856, "releases": { "0.0.0": [ { "comment_text": "", "digests": { "md5": "c89d19827e14889dcfdea470c9768ddf", "sha256": "ac21e1ea36977a725f8105bff35cc33d69cf823dd1f39977710c6374268967b0" }, "downloads": -1, "filename": "maildirwatch-0.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "c89d19827e14889dcfdea470c9768ddf", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 19453, "upload_time": "2019-03-11T12:20:08", "url": "https://files.pythonhosted.org/packages/42/70/215db7dfd2c590970257952ddd29105b674d8322358e37f5384b95dda7ef/maildirwatch-0.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e877212787fe4521285e98585bf5f64e", "sha256": "7b9cb25185df25bf8f4ace839eea75c593dce2406020707f46b47a40181e9046" }, "downloads": -1, "filename": "maildirwatch-0.0.0.tar.gz", "has_sig": false, "md5_digest": "e877212787fe4521285e98585bf5f64e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17926, "upload_time": "2019-03-11T12:20:11", "url": "https://files.pythonhosted.org/packages/44/29/a552a6f26145b91a7ed31320ae44d96fcfcc661a26d22cc06dac0c3343bd/maildirwatch-0.0.0.tar.gz" } ], "0.1.0": [ { "comment_text": "", "digests": { "md5": "99b1bdf934d51e40fa30fcad0b86d290", "sha256": "39f7c1fdf8023039737864f3c53d96035fc8bdaf39445c500d5daac6e273a43f" }, "downloads": -1, "filename": "maildirwatch-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "99b1bdf934d51e40fa30fcad0b86d290", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 20033, "upload_time": "2019-03-27T21:20:30", "url": "https://files.pythonhosted.org/packages/31/76/9d47f0e97e9ae1f5cc3728311f2e1e84e8b11dc46487d4e129cb38c6b2e5/maildirwatch-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ecddd4f8ba0000c9c1df47746b13cc19", "sha256": "0c946c3d1d0eeddde5204bffe0863855fff0ecb1039769258f8f84a44dd7249c" }, "downloads": -1, "filename": "maildirwatch-0.1.0.tar.gz", "has_sig": false, "md5_digest": "ecddd4f8ba0000c9c1df47746b13cc19", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18544, "upload_time": "2019-03-27T21:20:32", "url": "https://files.pythonhosted.org/packages/13/ab/7458466109bbd26b987462650a5b255585a03e8d5b51d372ae5701251dcc/maildirwatch-0.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "99b1bdf934d51e40fa30fcad0b86d290", "sha256": "39f7c1fdf8023039737864f3c53d96035fc8bdaf39445c500d5daac6e273a43f" }, "downloads": -1, "filename": "maildirwatch-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "99b1bdf934d51e40fa30fcad0b86d290", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 20033, "upload_time": "2019-03-27T21:20:30", "url": "https://files.pythonhosted.org/packages/31/76/9d47f0e97e9ae1f5cc3728311f2e1e84e8b11dc46487d4e129cb38c6b2e5/maildirwatch-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ecddd4f8ba0000c9c1df47746b13cc19", "sha256": "0c946c3d1d0eeddde5204bffe0863855fff0ecb1039769258f8f84a44dd7249c" }, "downloads": -1, "filename": "maildirwatch-0.1.0.tar.gz", "has_sig": false, "md5_digest": "ecddd4f8ba0000c9c1df47746b13cc19", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18544, "upload_time": "2019-03-27T21:20:32", "url": "https://files.pythonhosted.org/packages/13/ab/7458466109bbd26b987462650a5b255585a03e8d5b51d372ae5701251dcc/maildirwatch-0.1.0.tar.gz" } ] }