{"id":22290764,"url":"https://github.com/mberry/maildigests","last_synced_at":"2025-03-25T21:33:28.349Z","repository":{"id":144279773,"uuid":"98497263","full_name":"mberry/maildigests","owner":"mberry","description":"Concatenates emails from a search query into a single digest.","archived":false,"fork":false,"pushed_at":"2020-07-13T08:19:38.000Z","size":7,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-30T18:49:01.565Z","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":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mberry.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-07-27T05:28:22.000Z","updated_at":"2020-07-13T08:19:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"3df994e8-c510-47a8-aa9e-6d96c5080378","html_url":"https://github.com/mberry/maildigests","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mberry%2Fmaildigests","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mberry%2Fmaildigests/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mberry%2Fmaildigests/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mberry%2Fmaildigests/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mberry","download_url":"https://codeload.github.com/mberry/maildigests/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245549342,"owners_count":20633766,"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-12-03T17:14:03.595Z","updated_at":"2025-03-25T21:33:28.324Z","avatar_url":"https://github.com/mberry.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MailDigests\n\nCombines all emails fitting a specified search criteria, configured for gmail.\n\n## Install\n* Enable Gmail API access, as shown in **Step 1** of this guide:\nhttps://developers.google.com/gmail/api/quickstart/python\n\n* Install the python client \n    ```shell\n    pip install --upgrade google-api-python-client\n    ```\n* Install maildigests\n    ```shell\n    git clone https://github.com/MitchellBerry/maildigests.git\n    ```\n## Usage\n\nIntended to be used as a command line tool in combination with a scheduler.\n```bash\npython maildigests.py --help\n\nusage: maildigests.py [-h] [-s SEARCH] [-d DEPTH] [-l LOGLEVEL] [-f LOGFILE]\n                      [-p PLAINTEXT] [-t TOPIC]\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -s SEARCH, --search SEARCH\n                        Search query, same response as querying Gmail search\n                        box, can use advanced search operators. Check messages\n                        returned by the search response if getting unwanted\n                        results and adjust as necessary. Full list of\n                        operators:\n                        https://support.google.com/mail/answer/7190?hl=en\n  -d DEPTH, --depth DEPTH\n                        Maximum number of messages per digest, most recent\n                        emails are processed first. Default is 50\n  -l LOGLEVEL, --loglevel LOGLEVEL\n                        Options: \"debug\", \"info\", \"error\", no logging will\n                        occur with any other value. Default is info\n  -f LOGFILE, --logfile LOGFILE\n                        Set True to save log to file. Default is False\n  -p PLAINTEXT, --plaintext PLAINTEXT\n                        Process as plain text email instead of html. Default\n                        is False\n  -t TOPIC, --topic TOPIC\n                        Email subject line\n```\n\nExample\n\n```bash\npython maildigests.py -s \"from:googlealerts-noreply@google.com\" -d 10 -t \"Alerts Digest\"\n```\nGoogle API daily rate limits: https://developers.google.com/gmail/api/v1/reference/quota\n\nSearch query supports advanced operators, full list can be found here: https://support.google.com/mail/answer/7190?hl=en\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmberry%2Fmaildigests","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmberry%2Fmaildigests","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmberry%2Fmaildigests/lists"}