# README
mailck is a simple mail check utility, currently supporting IMAP, designed with the following in mind:
- light: small size and resource usage
- low dependencies: low or no external dependencies
- terminal-focused: terminal usage focused (input and output) - primarily focused on usage through conky
## Latest Changes
- changed --version to use importlib.metadata
### Notices
- it does not make much sense to run this more frequently than every 10s as connecting takes ~1-2s
### Features
- no configuration: install and run
- supports password or password-cmd (getting a password from an external command such as spw)
- scriptable: designed to be ran from conky, cron, or the command line
- minimal: around 250 lines of code, no dependencies
- safe: the code is clean and easy to review with no dependencies so you can easily review to see exactly what it does
### Requirements
- python
### Overview
mailck is a utility to check mail. The default usage simply returns a count of new (unseen) messages but you can have it return a summary (showing From, Date, and Subject) of the messages if needed. See `--help` and the Examples section below for more details.
We use mailck daily via conky to check several mail accounts. mailck was designed for this purpose and built because we could not find a simple, trustworthy application for this that is currently maintained. mailck has no dependencies so keeping it up-to-date is simple but we strive to keep the application functioning as designed and to address any issues quickly.
### Comments / Issues / Feedback
If you find an issue, have a question, or would like a feature added please create an issue as we would be happy to hear from you.
- [issues](https://gitlab.com/drad/mailck/-/issues)
### Install
We recommend using [pipx](https://github.com/pypa/pipx). To install:
- with pipx: `pipx install mailck`
- with pip: `pip install --user mailck`
### Usage
Using mailck is straightforward, see `--help` for details or the Examples section below for example usage.
By default, mailck uses LOG_LEVEL=WARNING which shows minimal extra info. If you are having issues you may want to increase application verbosity by setting the LOG_LEVEL to 'DEBUG'. You can do this by setting a LOG_LEVEL envvar (e.g. `LOG_LEVEL='DEBUG' mailck --server mail.example.com --port 993 --username me@example.com --password='my-password'`). Valid values for LOG_LEVEL are as follow: [CRITICAL|ERROR|WARNING|INFO|DEBUG] (suggest WARNING).
### Examples
- Terminal Usage:
- basic: `mailck --server mail.example.com --port 993 --username me@example.com --password='my-password'`
+ output: `0` # indicating no new email
- basic with password-cmd: `mailck --server mail.example.com --port 993 --username me@example.com --password-cmd='spw -g mail/example@x -u'`
+ output: `0` # indicating no new email
- add prefix and suffix with password-cmd: `mailck --server mail.example.com --port 993 --username me@example.com --password-cmd='spw -g mail/example@x -u' --prefix='example@x: ' --suffix=" (new)"`
+ output: `example@x: 0 (new)` # indicating no new email
- basic with password-cmd returning message summary: `mailck --server mail.example.com --port 993 --username me@example.com --password-cmd='spw -g mail/example@x -u' -m true --prefix='Total: ' --suffix=' (new)'`
+ output:
```
SA <sa@adercon.com>, 2023-12-20 20:58, Example Email 1
SA <sa@adercon.com>, 2023-12-20 20:59, Example Email 2
Total: 2 (new)
```
- conky usage:
```
conky.text = [[
...
Mail:
- devops@ac: ${texeci 60 mailck --server mail.example.com --username me@example.com --password-cmd='spw -g mail/me@ac -u' --suffix=' (new)'}
- dr@ac: ${texeci 60 mailck --server mail.example.com --username dr@example.com --password-cmd='spw -g mail/dr@ac -u' --suffix=' (new)'}
...
]]
```
will produce something like the following in conky:
```
...
Mail:
- devops@ac: 2 (new)
- dr@ac 0 (new)
...
```
### Links
- [source code](https://gitlab.com/drad/mailck)
- [issues](https://gitlab.com/drad/mailck/-/issues)
Raw data
{
"_id": null,
"home_page": "https://gitlab.com/drad/mailck",
"name": "mailck",
"maintainer": "drad",
"docs_url": null,
"requires_python": "<4.0,>=3.11",
"maintainer_email": "sa@adercon.com",
"keywords": "mail, imap, check, conky, cron, terminal, email",
"author": "drad",
"author_email": "sa@adercon.com",
"download_url": "https://files.pythonhosted.org/packages/09/b3/2f64a4bc77c8e79ee8978189e26fe20bbcaa3ead56d80ea3588199c6aec0/mailck-0.3.0.tar.gz",
"platform": null,
"description": "# README\n\nmailck is a simple mail check utility, currently supporting IMAP, designed with the following in mind:\n\n- light: small size and resource usage\n- low dependencies: low or no external dependencies\n- terminal-focused: terminal usage focused (input and output) - primarily focused on usage through conky\n\n\n## Latest Changes\n\n- changed --version to use importlib.metadata\n\n\n### Notices\n\n- it does not make much sense to run this more frequently than every 10s as connecting takes ~1-2s\n\n\n### Features\n\n- no configuration: install and run\n- supports password or password-cmd (getting a password from an external command such as spw)\n- scriptable: designed to be ran from conky, cron, or the command line\n- minimal: around 250 lines of code, no dependencies\n- safe: the code is clean and easy to review with no dependencies so you can easily review to see exactly what it does\n\n\n### Requirements\n\n- python\n\n\n### Overview\n\nmailck is a utility to check mail. The default usage simply returns a count of new (unseen) messages but you can have it return a summary (showing From, Date, and Subject) of the messages if needed. See `--help` and the Examples section below for more details.\n\nWe use mailck daily via conky to check several mail accounts. mailck was designed for this purpose and built because we could not find a simple, trustworthy application for this that is currently maintained. mailck has no dependencies so keeping it up-to-date is simple but we strive to keep the application functioning as designed and to address any issues quickly.\n\n\n### Comments / Issues / Feedback\n\nIf you find an issue, have a question, or would like a feature added please create an issue as we would be happy to hear from you.\n\n- [issues](https://gitlab.com/drad/mailck/-/issues)\n\n\n### Install\n\nWe recommend using [pipx](https://github.com/pypa/pipx). To install:\n\n- with pipx: `pipx install mailck`\n- with pip: `pip install --user mailck`\n\n\n### Usage\n\nUsing mailck is straightforward, see `--help` for details or the Examples section below for example usage.\n\nBy default, mailck uses LOG_LEVEL=WARNING which shows minimal extra info. If you are having issues you may want to increase application verbosity by setting the LOG_LEVEL to 'DEBUG'. You can do this by setting a LOG_LEVEL envvar (e.g. `LOG_LEVEL='DEBUG' mailck --server mail.example.com --port 993 --username me@example.com --password='my-password'`). Valid values for LOG_LEVEL are as follow: [CRITICAL|ERROR|WARNING|INFO|DEBUG] (suggest WARNING).\n\n\n### Examples\n\n- Terminal Usage:\n - basic: `mailck --server mail.example.com --port 993 --username me@example.com --password='my-password'`\n + output: `0` # indicating no new email\n - basic with password-cmd: `mailck --server mail.example.com --port 993 --username me@example.com --password-cmd='spw -g mail/example@x -u'`\n + output: `0` # indicating no new email\n - add prefix and suffix with password-cmd: `mailck --server mail.example.com --port 993 --username me@example.com --password-cmd='spw -g mail/example@x -u' --prefix='example@x: ' --suffix=\" (new)\"`\n + output: `example@x: 0 (new)` # indicating no new email\n - basic with password-cmd returning message summary: `mailck --server mail.example.com --port 993 --username me@example.com --password-cmd='spw -g mail/example@x -u' -m true --prefix='Total: ' --suffix=' (new)'`\n + output:\n ```\n SA <sa@adercon.com>, 2023-12-20 20:58, Example Email 1\n SA <sa@adercon.com>, 2023-12-20 20:59, Example Email 2\n Total: 2 (new)\n ```\n- conky usage:\n ```\n conky.text = [[\n ...\n Mail:\n - devops@ac: ${texeci 60 mailck --server mail.example.com --username me@example.com --password-cmd='spw -g mail/me@ac -u' --suffix=' (new)'}\n - dr@ac: ${texeci 60 mailck --server mail.example.com --username dr@example.com --password-cmd='spw -g mail/dr@ac -u' --suffix=' (new)'}\n ...\n ]]\n ```\n will produce something like the following in conky:\n ```\n ...\n Mail:\n - devops@ac: 2 (new)\n - dr@ac 0 (new)\n ...\n ```\n\n\n### Links\n\n- [source code](https://gitlab.com/drad/mailck)\n- [issues](https://gitlab.com/drad/mailck/-/issues)\n",
"bugtrack_url": null,
"license": "GPL-3.0-only",
"summary": "a simple mail check utility, currently supporting IMAP",
"version": "0.3.0",
"project_urls": {
"Homepage": "https://gitlab.com/drad/mailck",
"Repository": "https://gitlab.com/drad/mailck"
},
"split_keywords": [
"mail",
" imap",
" check",
" conky",
" cron",
" terminal",
" email"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2bc422fdf94e2b5511dd87523e18cae65b494a3fdaefb30b7c0691d4440ece23",
"md5": "7975bbd4b255cb78ec9f8d486b4f6b2f",
"sha256": "35db27acf058032da026efcca5c38160005e84f4523016699c13ac0ec3d1c1b2"
},
"downloads": -1,
"filename": "mailck-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7975bbd4b255cb78ec9f8d486b4f6b2f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.11",
"size": 16742,
"upload_time": "2024-04-05T09:50:39",
"upload_time_iso_8601": "2024-04-05T09:50:39.997046Z",
"url": "https://files.pythonhosted.org/packages/2b/c4/22fdf94e2b5511dd87523e18cae65b494a3fdaefb30b7c0691d4440ece23/mailck-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "09b32f64a4bc77c8e79ee8978189e26fe20bbcaa3ead56d80ea3588199c6aec0",
"md5": "5071f610639d7db17ddf900170293deb",
"sha256": "79d5e85e8dc0a3de57c4f1ff86f178b1fea4b34b0cee965d8e4c3c926a7dec09"
},
"downloads": -1,
"filename": "mailck-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "5071f610639d7db17ddf900170293deb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.11",
"size": 15904,
"upload_time": "2024-04-05T09:50:41",
"upload_time_iso_8601": "2024-04-05T09:50:41.858421Z",
"url": "https://files.pythonhosted.org/packages/09/b3/2f64a4bc77c8e79ee8978189e26fe20bbcaa3ead56d80ea3588199c6aec0/mailck-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-05 09:50:41",
"github": false,
"gitlab": true,
"bitbucket": false,
"codeberg": false,
"gitlab_user": "drad",
"gitlab_project": "mailck",
"lcname": "mailck"
}
JSON