{"id":18283164,"url":"https://github.com/johnkun136nvcp/pymailcat","last_synced_at":"2025-04-05T07:30:28.600Z","repository":{"id":242868736,"uuid":"810747523","full_name":"JohnKun136NVCP/PyMailCat","owner":"JohnKun136NVCP","description":"This repository houses a delightful graphical interface for sending emails with attachments. Whether it’s PDFs or images, our feline postman ensures your messages reach their destination with a touch of whiskered charm. 🐾📧🐱","archived":false,"fork":false,"pushed_at":"2024-06-21T01:21:01.000Z","size":663,"stargazers_count":4,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-20T23:41:56.363Z","etag":null,"topics":["basic","cat","csv-files","dearpygui","email-sender","excel","gitkraken","gmail-smtp","graphical-interface","learn","linux","macos","outlook-smtp","pandas","python","smtp","whiskered-charm","windows","yahoo-smtp"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JohnKun136NVCP.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2024-06-05T09:29:26.000Z","updated_at":"2024-08-03T03:35:50.000Z","dependencies_parsed_at":"2024-06-21T19:51:01.377Z","dependency_job_id":null,"html_url":"https://github.com/JohnKun136NVCP/PyMailCat","commit_stats":null,"previous_names":["johnkun136nvcp/pymailcat"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnKun136NVCP%2FPyMailCat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnKun136NVCP%2FPyMailCat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnKun136NVCP%2FPyMailCat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnKun136NVCP%2FPyMailCat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JohnKun136NVCP","download_url":"https://codeload.github.com/JohnKun136NVCP/PyMailCat/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247305089,"owners_count":20917191,"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":["basic","cat","csv-files","dearpygui","email-sender","excel","gitkraken","gmail-smtp","graphical-interface","learn","linux","macos","outlook-smtp","pandas","python","smtp","whiskered-charm","windows","yahoo-smtp"],"created_at":"2024-11-05T13:07:57.379Z","updated_at":"2025-04-05T07:30:27.989Z","avatar_url":"https://github.com/JohnKun136NVCP.png","language":"Python","readme":"\u003cp align=\"right\"\u003e\n    \u003cimg src=\"./src/email-sent.png\" with=\"15px\" heigh=\"15px\" align=\"right\"\u003e\n\u003c/p\u003e\n\n# PyMailCat 🐈📧\n\nPyMailCat is a Python interface built using Dear PyGui. It provides a user-friendly way to manage emails and perform various tasks related to email communication.\n\nThis repository houses a delightful graphical interface for sending emails with attachments. Whether it’s PDFs or images, our feline postman ensures your messages reach their destination with a touch of whiskered charm. 🐾📧🐱\n\n## Features\n\n- **Compose Email**: Create and send new emails.\n- **Search**: Search for specific emails based on keywords or sender.\n- **Attachments**: Handle email attachments.\n- **Settings**: Configure your email recipients and preferences.\n\n## Installation 🔧\n\n1. Clone this repository:\n   ```\n   git clone https://github.com/JohnKun136NVCP/PyMailCat.git\n   ```\n2. Enter the repository directory\n\n   ```\n   cd PyMailCat/\n   ```\n3. Install dependencies:\n   ```\n   pip install -r requirements.txt \n   ```\n4. Run the application:\n   ```\n   python main.py\n   ```\n\n## SMTP Services Available\n- Gmail. You need two factor authentication and create password app. See more here [sign in with app passwords\n](https://support.google.com/accounts/answer/185833?hl=en\u0026sjid=2504093778559336064-NC\u0026dark=1).\n- Outlook (use your personal password)\n- Yahoo (user your personal password)\n## How it works?.\n1. Enter your e-mail address\n2. Enter your subject\n3. ⚠️ Important! Choose whether you want to add a recipient manually. However, if you choose a file, the program will open the file browser. Select your TXT or Excel or CSV file.\n4. ⚠️ If you choose to write your body manually, it is important that you select the *Manual text* button. You can upload TXT (supports UTF-8) or html (also supports UTF-8) files.\n5. (OPTIONAL) You can upload images or PDF files. (⚠️ Make sure that both are in the same directory if you choose *Both*).\n6. Tab. Important. ⚠️. Choose the *manual* option before typing your token and then select *Google* if it is your SMTP service.\n7. Send your email(s)\n\n⚠️ If you have more than 200 recipients, Google does not allow you to send many emails.\n## Interface\n\n![](/img/email_cat_1.png)\n\n![](/img/email_cat_1%20-%20param.png)\n\n## Sending emails\n![](/img/email_cat-sender.png)\n\n![](/img/email_cat-popupgood.png)\n\n![](/img/sender-ok.png)\n\n## Empty email or sending with wrong data\n\n![](/img/email_cat-popupbad.png)\n\n## Considerations\n\n\u003e[!NOTE]\n\u003e For **Gmail acount**. You need two factor authentication and create password app. See more here [sign in with app passwords\n](https://support.google.com/accounts/answer/185833?hl=en\u0026sjid=2504093778559336064-NC\u0026dark=1).\n\u003e For **Outlook and Yahoo aconnt**. You will need to use your personal password\n\n\u003e[!WARNING]\n\u003eChoose whether you want to add a recipient manually. However, if you choose a file, the program will open the file browser. Select your TXT or Excel or CSV file (Your column of your email must say 'Email'.)\n\n\u003e[!WARNING]\n\u003eIf you choose to write your body manually, it is important that you select the *Manual text* button. You can upload TXT (supports UTF-8) or html (also supports UTF-8) files.\n\n\u003e[!NOTE]\n\u003e(OPTIONAL) You can upload images or PDF files. (Make sure that both are in the same directory if you choose *Both*).\n\n\u003e[!NOTE]\n\u003eTab. Important. Choose the *manual* option before typing your token and then select *Google* if it is your SMTP service.\n\n\u003e[!WARNING]\n\u003eGoogle only admits 1\u003c=100 recipients by email\n\n\u003e[!NOTE]\n\u003eUse **upload size** if you upload PDF files, HTML as body or pictures, since emails over 20MB, It won't send. (Size of email must be below 20MB)\n\n\n## Available on\n- Windows\n- Linux\n- MacOS\n\n## Contributing\n\nContributions are welcome! If you find any issues or have suggestions, feel free to open an issue or submit a pull request.\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnkun136nvcp%2Fpymailcat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohnkun136nvcp%2Fpymailcat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnkun136nvcp%2Fpymailcat/lists"}