Skip to content

Latest commit

 

History

History
104 lines (74 loc) · 3.78 KB

README.md

File metadata and controls

104 lines (74 loc) · 3.78 KB

PyMailCat 🐈📧

PyMailCat 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.

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. 🐾📧🐱

Features

  • Compose Email: Create and send new emails.
  • Search: Search for specific emails based on keywords or sender.
  • Attachments: Handle email attachments.
  • Settings: Configure your email recipients and preferences.

Installation 🔧

  1. Clone this repository:

    git clone https://github.com/JohnKun136NVCP/PyMailCat.git
    
  2. Enter the repository directory

    cd PyMailCat/
    
  3. Install dependencies:

    pip install -r requirements.txt 
    
  4. Run the application:

    python main.py
    

SMTP Services Available

  • Gmail. You need two factor authentication and create password app. See more here sign in with app passwords .
  • Outlook (use your personal password)
  • Yahoo (user your personal password)

How it works?.

  1. Enter your e-mail address
  2. Enter your subject
  3. ⚠️ 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.
  4. ⚠️ 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.
  5. (OPTIONAL) You can upload images or PDF files. (⚠️ Make sure that both are in the same directory if you choose Both).
  6. Tab. Important. ⚠️. Choose the manual option before typing your token and then select Google if it is your SMTP service.
  7. Send your email(s)

⚠️ If you have more than 200 recipients, Google does not allow you to send many emails.

Interface

Sending emails

Empty email or sending with wrong data

Considerations

Note

For Gmail acount. You need two factor authentication and create password app. See more here sign in with app passwords . For Outlook and Yahoo aconnt. You will need to use your personal password

Warning

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 (Your column of your email must say 'Email'.)

Warning

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.

Note

(OPTIONAL) You can upload images or PDF files. (Make sure that both are in the same directory if you choose Both).

Note

Tab. Important. Choose the manual option before typing your token and then select Google if it is your SMTP service.

Warning

Google only admits 1<=100 recipients by email

Note

Use 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)

Available on

  • Windows
  • Linux
  • MacOS

Contributing

Contributions are welcome! If you find any issues or have suggestions, feel free to open an issue or submit a pull request.