{"id":37081762,"url":"https://github.com/msinamsina/pyautomail","last_synced_at":"2026-01-14T09:57:05.205Z","repository":{"id":51684212,"uuid":"306283855","full_name":"msinamsina/pyautomail","owner":"msinamsina","description":"Automated Email Sending for Large Scale Email and Gmail Automation","archived":false,"fork":false,"pushed_at":"2023-08-26T01:41:49.000Z","size":3278,"stargazers_count":36,"open_issues_count":2,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-13T12:52:59.781Z","etag":null,"topics":["automail","automailer","automated-email-communication","automation","bulk-email","email","email-automation","email-automation-python","email-automation-tool","email-sender","email-template","gmail","large-scale-email-sending","mass-email-sending","pyautomail","pyautomailer","python-automail","python-email-automation","python-package","smtp"],"latest_commit_sha":null,"homepage":"https://msinamsina.github.io/pyautomail/","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/msinamsina.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,"governance":null}},"created_at":"2020-10-22T09:14:31.000Z","updated_at":"2025-09-12T12:27:25.000Z","dependencies_parsed_at":"2023-07-26T03:34:50.778Z","dependency_job_id":null,"html_url":"https://github.com/msinamsina/pyautomail","commit_stats":{"total_commits":137,"total_committers":1,"mean_commits":137.0,"dds":0.0,"last_synced_commit":"3bfa3839cb60ac2694413867a92b2e2234d3b6bc"},"previous_names":["msinamsina/automail","msinamsina/pyautomail"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/msinamsina/pyautomail","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msinamsina%2Fpyautomail","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msinamsina%2Fpyautomail/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msinamsina%2Fpyautomail/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msinamsina%2Fpyautomail/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/msinamsina","download_url":"https://codeload.github.com/msinamsina/pyautomail/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msinamsina%2Fpyautomail/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28416199,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T08:38:59.149Z","status":"ssl_error","status_checked_at":"2026-01-14T08:38:43.588Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["automail","automailer","automated-email-communication","automation","bulk-email","email","email-automation","email-automation-python","email-automation-tool","email-sender","email-template","gmail","large-scale-email-sending","mass-email-sending","pyautomail","pyautomailer","python-automail","python-email-automation","python-package","smtp"],"created_at":"2026-01-14T09:57:04.534Z","updated_at":"2026-01-14T09:57:05.199Z","avatar_url":"https://github.com/msinamsina.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PyAutoMail: A Python package and command-line interface for automation sending email to your contact list\n\n\n[![Documentation Status](https://readthedocs.org/projects/pyautomail/badge/?version=latest)](https://pyautomail.readthedocs.io/en/latest/?badge=latest)\n![PyPI](https://img.shields.io/pypi/v/pyautomail?label=pypi%20pyautomail)\n![PyPI - Downloads](https://img.shields.io/pypi/dm/pyautomail)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n![example workflow](https://github.com/msinamsina/pyautomail/actions/workflows/python-publish.yml/badge.svg)\n\n-----\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./docs/_static/automail-logo.png\"/\u003e\n\u003c/div\u003e\n\u003cbr\u003e\n\n\nPyautomail, an incredibly powerful Python package meticulously crafted for the purpose of automated email delivery, catering especially to large-scale Email or Gmail automation. In today's fast-paced digital era, effective communication stands as a crucial cornerstone for numerous businesses and projects that heavily rely on email as their primary medium of interaction. Nonetheless, the manual handling of individual emails or the management of bulk email campaigns can prove to be both time-consuming and prone to errors.\n\nFear not, for pyautomail swoops in as the ultimate savior, offering a seamless and highly efficient solution for automating email communication. Be it the need to dispatch personalized emails to a vast audience, the execution of targeted email marketing campaigns, or the automation of repetitive email chores, this package serves as your ultimate go-to tool. With its user-friendly interface and an array of versatile features, pyautomail proves itself as a fitting choice for a wide range of applications, catering to startups, enterprises, professionals, and developers alike.\n\nRevolutionize your email operations, whether it involves mass email distribution, streamlined Gmail tasks, or the quest for enhanced email communication proficiency - pyautomail is here to streamline your workflow, elevate your efficiency, and elevate productivity to soaring heights.\n\n\n## Installation\n\n### [PyPi](https://pypi.org/project/pyautomail/)\n```bash\npip install pyautomail\n```\n\n### [Github](https://github.com/msinamsina/pyautomail.git)\n```bash\npip install git+https://github.com/msinamsina/pyautomail.git\n```\n\n## How to use in command-line interface\n\n1. At first, you should initialize project\n    ```bash\n    python -m pyautomail init\n    ```\n    \n   After running this command, you will see a some questions. You should answer them.\n    \n   ```bash\n   Where do you want to initialize the pyautomail project? [./pyautomail-workspace]\n   What is your smtp server? [smtp.gmail.com]:\n   What is your smtp port? [465]:\n   ```\n   \n    **📘 Note:**   \n    1. This command will create a folder with the project name in the path you specified. \n    If you don't specify the path, it will create ```automail-workspace```.  \n    2. You can change the default smtp server by default it has been set on **Gmail Smtp Server**. \n    3. You also can set the port of **Smtm Server** (by default 465).\n    4. Additionally, if you want to save you password in config file, you can use the ```-p``` or \n   ```--pasword``` switch.\n    5. Moreover, if you want to initialize a test project, you can use ```-t``` or ```--test```. \n       ```bash\n       $ python -m pyautomail init -t -p \u003cyour-password\u003e\n       ```\n\n   \u003e **[📙 Important]()**  \n   \u003e If directory already exists, it will be overwritten.\n   \n1. Then you should go to the project directory and register your contact list\n    ```bash\n    cd \u003cyour-project-name\u003e\n    python -m pyautomail register \u003cPath-to-your-contact-list\u003e [options]\n   ```\n   **📘 Note:**   \n   For using a template, use ```--template``` switch. The template can be ```.txt``` or ```.html```\n   Format.\n   ```bash\n   python -m pyautomail register contact-list.csv --template ./body.html\n   ```\n   **body.html:**\n   ```html\n   \u003ch1\u003e Hi {{ name }}, \u003c/h1\u003e\n   ```\n   **contact-list.csv:**\n   ```csv\n   email,name,data1,cpdf\n   contact1@gmail.com,contact1,ali,/path/to/pdf1\n   contact2@gmail.com,contact2,mohammad,/path/to/pdf2\n   contact3@gmail.com,contact3,soheila,/path/to/pdf3\n   ```\n   \n1. Now you can start sending emails by running the following command\n   ```bash\n   python -m pyautomail start \u003cprocess-id\u003e\n   ```\n   \n## How to use in python\n\n```python\n    from pyautomail import EmailSender\n    email_sender = EmailSender('config.cfg')\n    email_sender.set_template('body.txt')\n    data = {'name': 'Jon', 'age': 30}\n    email_sender.send('msinamsina@gmail.com', 'sub1', data)\n```\n\n## Documentation and Resources\n\nFor more comprehensive information about **PyAutoMail** and its capabilities, please explore our detailed [documentation](https://pyautomail.readthedocs.io/en/latest/).\n\n- Get a brief overview and explore the features of PyAutoMail in the [Introduction](https://pyautomail.readthedocs.io/en/latest/introduction.html) section.\n- If you're new to PyAutoMail, follow our [Getting Started](https://pyautomail.readthedocs.io/en/latest/getting-started.html) guide to kickstart your email automation journey.\n- For a quick reference, you can check out the [API Reference](https://pyautomail.readthedocs.io/en/latest/api/index.html) section.\n- To gain deeper insights into PyAutoMail and learn best practices, dive into our informative [Tutorial](https://pyautomail.readthedocs.io/en/latest/tutorial/index.html) section.\n\nBy exploring these resources, you'll harness the full potential of PyAutoMail and make the most out of its powerful email automation capabilities.\n\n---\n\n## Contribution and Support\n\nWe welcome contributions from the community to enhance **PyAutoMail** and make it even more robust. If you're interested in contributing, here's how you can get involved:\n\n1. **Bug Reports and Feature Requests**: If you come across any issues or have ideas for new features, please [open an issue](https://github.com/msinamsina/automail/issues) on our GitHub repository. We appreciate detailed bug reports with steps to reproduce the problem and clear feature requests with use cases.\n\n2. **Pull Requests**: If you want to contribute code to PyAutoMail, you can do so by submitting a pull request. Please ensure that your code adheres to the existing code style, and include relevant tests to maintain code quality.\n\n3. **Documentation**: Improving the documentation is always valuable. If you find any inconsistencies or areas that need clarification, feel free to submit documentation updates via pull requests.\n\n4. **Spread the Word**: If you find PyAutoMail useful, help us spread the word by sharing it with your peers and on social media platforms.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsinamsina%2Fpyautomail","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmsinamsina%2Fpyautomail","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsinamsina%2Fpyautomail/lists"}