{"id":16521585,"url":"https://github.com/agherzan/notifymail","last_synced_at":"2025-10-15T11:44:52.057Z","repository":{"id":12734111,"uuid":"15407049","full_name":"agherzan/notifymail","owner":"agherzan","description":"IMAP email desktop notifier using pynotify","archived":false,"fork":false,"pushed_at":"2014-01-09T20:26:57.000Z","size":264,"stargazers_count":3,"open_issues_count":1,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-13T13:28:49.292Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://gitpull.gherzan.ro/gitpull/notify-linux-desktop-when-new-email-arrives-on-imap-servers/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/agherzan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-12-23T23:35:34.000Z","updated_at":"2020-08-29T09:04:48.000Z","dependencies_parsed_at":"2022-09-06T03:10:11.531Z","dependency_job_id":null,"html_url":"https://github.com/agherzan/notifymail","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agherzan%2Fnotifymail","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agherzan%2Fnotifymail/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agherzan%2Fnotifymail/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agherzan%2Fnotifymail/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/agherzan","download_url":"https://codeload.github.com/agherzan/notifymail/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241596622,"owners_count":19988106,"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-10-11T16:57:03.162Z","updated_at":"2025-10-15T11:44:47.010Z","avatar_url":"https://github.com/agherzan.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"##Table of Contents##\n- [A. Description](#a-description)\n- [B. Installation](#b-installation)\n    - [B.1. Prerequisites](#b1-prerequisites)\n    - [B.2. Install](#b2-install)\n- [C. Configuration](#c-configuration)\n- [D. Running notifmail](#d-running-notifmail)\n- [E. notifmail 'home' directory](#e-notifmail-home-directory)\n    - [E.1. notifmail.conf](#e1-notifmailconf)\n    - [E.2. notifmail.log](#e2-notifmaillog)\n    - [E.3. notifmail.lock](#e3-notifmaillock)\n\n\nA. Description\n==============\nnotifmail is an email daemon checker which notifies system about new emails on\nconfigured IMAP servers.\n\n\nB. Installation\n===============\n\nB.1. Prerequisites\n------------------\nHave python and other prerequisites on host:\n\n* python\n* python-notify2\n* openssl\n* python-daemon\n\nExample - Fedora:\n\n    $ sudo yum install python openssl python-daemon python-pip\n    $ sudo pip install notify2\n\nExample - Ubuntu:\n\n    $ sudo apt-get install python python-notify2 openssl python-daemon\n\nB.2. Install\n------------\n    $ cd \u003cnotifmail git clone directory\u003e\n    $ sudo ./setup.py install\n\n\nC. Configuration\n================\nnotifmail uses a configuration for connection to IMAP server and for other\nconfigurations. A sample file one is packaged in the sources as\n\"notifmail.conf.sample\". To get started copy this file in ~/.notifmail:\n\n    $ mkdir ~/.notifmail\n    $ cp ./notifmail.conf.sample ~/.notifmail/notifmail.conf\n\nEdit ~/.notifmail/notifmail.conf.sample with your configuration.\n\n\nD. Running notifmail\n====================\n\nTo start notifmail:\n\n    $ notifmail\n\nFor more info about notifmail's command line parameters:\n\n    $ notifmail -h\n\nE. notifmail 'home' directory\n==========================\nnotifmail's 'home' directory is located in $HOME/.notifmail and contains:\n\nE.1. notifmail.conf\n-------------------\nThis file contains the IMAP accounts configuration to be used by notifmail.\nCan contain multiple accounts but each account must include:\n\n* `imap_server`\n* `imap_user`\n* `imap_password`\n\nThere are two optional variables:\n\n* `all`: Used to define mailboxes for which notifmail should trigger a\nnotification with every new email. Multiple mailboxes must be separated by\nsemicolon.\n* `summary`: Used to define mailboxes for which notifmail should trigger one\nsummary notification. Multiple mailboxes must be separated by semicolon.\nSee C. Configuration also.\n\nE.2. notifmail.log\n------------------\nThis is the logging file. By default notifmail runs as daemon so all messages go\nto this file. If you run daemon in foreground, log messages will be duplicated\nbetween logfile and stdout. For more info run:\n\n    $ notifmail -h\n\nE.3. notifmail.lock\n-------------------\nThis is a lock file to avoid having multiple notifmail instances.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagherzan%2Fnotifymail","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagherzan%2Fnotifymail","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagherzan%2Fnotifymail/lists"}