https://github.com/johnkun136nvcp/pymailcat

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. 🐾📧🐱
https://github.com/johnkun136nvcp/pymailcat

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

Last synced: 6 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/johnkun136nvcp/pymailcat
• Owner: JohnKun136NVCP
• License: gpl-3.0
• Created: 2024-06-05T09:29:26.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-06-21T01:21:01.000Z (over 1 year ago)
• Last Synced: 2025-03-20T23:41:56.363Z (7 months ago)
• 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
• Language: Python
• Homepage:
• Size: 647 KB
• Stars: 4
• Watchers: 1
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          


    



# 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

](https://support.google.com/accounts/answer/185833?hl=en&sjid=2504093778559336064-NC&dark=1).

- 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

![](/img/email_cat_1.png)

![](/img/email_cat_1%20-%20param.png)

## Sending emails

![](/img/email_cat-sender.png)

![](/img/email_cat-popupgood.png)

![](/img/sender-ok.png)

## Empty email or sending with wrong data

![](/img/email_cat-popupbad.png)

## Considerations

>[!NOTE]

> For **Gmail acount**. You need two factor authentication and create password app. See more here [sign in with app passwords

](https://support.google.com/accounts/answer/185833?hl=en&sjid=2504093778559336064-NC&dark=1).

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