{"id":25638450,"url":"https://github.com/dros1986/emailclient","last_synced_at":"2025-04-15T00:09:27.663Z","repository":{"id":41069111,"uuid":"267347021","full_name":"dros1986/EmailClient","owner":"dros1986","description":"Email Client for reading and sending emails.","archived":false,"fork":false,"pushed_at":"2022-06-28T09:07:06.000Z","size":18,"stargazers_count":8,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-15T00:09:08.801Z","etag":null,"topics":["email","email-client","email-reader","email-sender","gmail","gmail-api","gmail-python","google-mail","imap","imap-client","mail","pip","smtp","smtp-client"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dros1986.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-05-27T14:49:38.000Z","updated_at":"2025-02-14T10:28:31.000Z","dependencies_parsed_at":"2022-08-25T18:21:17.679Z","dependency_job_id":null,"html_url":"https://github.com/dros1986/EmailClient","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/dros1986%2FEmailClient","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dros1986%2FEmailClient/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dros1986%2FEmailClient/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dros1986%2FEmailClient/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dros1986","download_url":"https://codeload.github.com/dros1986/EmailClient/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248981268,"owners_count":21193147,"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":["email","email-client","email-reader","email-sender","gmail","gmail-api","gmail-python","google-mail","imap","imap-client","mail","pip","smtp","smtp-client"],"created_at":"2025-02-23T02:29:55.118Z","updated_at":"2025-04-15T00:09:27.634Z","avatar_url":"https://github.com/dros1986.png","language":"Python","readme":"## Usage\nThis library is really easy to use:\n\n```python\nfrom supermail import EmailClient\n\n# define email client\ngmail = EmailClient(\"your_email@gmail.com\", \"your_password\")\n\n# get all messages\nmessages = gmail.read() # if you need only unread, set parameter filter=['UNSEEN']\n\n# for each message\nfor msg in messages:\n\t# get message info\n\tprint(msg.subject())\n\tprint(msg.message())\n\tprint(msg.sender())\n\t# get attachments\n\tattachments = msg.attachments('./temp') # returns a list of filenames saved in specified dir\n\n# send a message with attachments\ngmail.send('recipient@gmail.com', 'Nice subject', 'Nice message', \\\n\tcc='xxx@domain.it',\n\tattachments=['/path/to/pdf.pdf', '/path/to/image.png'])\n```\n\n## Note\nIn order to use GMail, you need to log into [your security page](https://myaccount.google.com/security) and:\n1. enable two-step verification\n2. right below, it will appear an option called **App Password**. Create a new one that you will be able to use with supermail.\n\n\n## Other email? No problem!\nYou can specify custom imap and smtp addresses and ports:\n\n```python\nemail_address = \"your_email@gmail.com\"\nemail_pwd = \"your_password\"\nimap_server = \"imap.gmail.com\"\nimap_port   = 993\nsmtp_server='smtp.gmail.com'\nsmtp_port=587\n\n# define email client\ngmail = EmailClient(email_address, email_pwd, imap_server, imap_port, smtp_server, smtp_port)\n```\n\n\n## Install\nYou can install supermail from PyPI:\n```bash\npip install supermail\n```\n\nor from the github page:\n\n```bash\npip install git+https://github.com/dros1986/EmailClient.git\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdros1986%2Femailclient","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdros1986%2Femailclient","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdros1986%2Femailclient/lists"}