MailSender

Aplicação desktop para envio de emails em lote com interface gráfica moderna, construída com Python e ttkbootstrap.

Funcionalidades

• Interface moderna com tema escuro/claro
• Envio de emails em lote com personalização por destinatário ({nome}, {email})
• Suporte a mensagens em texto puro ou HTML
• Importação de contatos via CSV ou Excel
• Adição manual de destinatários
• Visualização prévia do email antes do envio
• Log detalhado com opção de exportação
• Configuração de servidor SMTP personalizado

Requisitos

• Python 3.8 ou superior

Instalação

1. Clone o repositório:

git clone https://github.com/peedro-lazzarin/mailsender.git
cd mailsender

2. Crie um ambiente virtual:

python -m venv .venv
source .venv/bin/activate  # Linux/Mac
.venv\Scripts\activate     # Windows

3. Instale as dependências:

pip install -r requirements.txt

Uso

python main.py

1. Na aba Configurações, insira seu email e senha

   • Gmail: use uma senha de app (não a senha da conta)
   • Outros provedores: ajuste o servidor SMTP e a porta

2. Adicione destinatários manualmente ou importe um arquivo CSV/Excel com colunas nome e email

3. Componha a mensagem — use {nome} e {email} para personalizar por destinatário

4. Clique em Visualizar para conferir e Enviar Emails para disparar

Estrutura do Projeto

mailSender/
├── src/
│   ├── gui/
│   │   ├── app.py               # Janela principal
│   │   ├── components/          # Abas e componentes da interface
│   │   └── themes/              # Estilos customizados
│   ├── services/                # Lógica de envio de email e leitura de arquivos
│   └── utils/                   # Constantes e utilitários
├── tests/                       # Testes automatizados
├── main.py                      # Ponto de entrada
└── requirements.txt             # Dependências

Dependências

Pacote	Versão mínima	Uso
ttkbootstrap	1.10.1	Interface gráfica
pandas	2.2.0	Leitura de CSV/Excel
openpyxl	3.1.2	Suporte a arquivos .xlsx
Pillow	10.0.0	Ícone da aplicação