emailer-inao 4.0.1
A personalized email campaign management tool
Requires Python: >=3.8

# Emailer-INAO

**Send personalized emails to multiple people easily and securely**

Emailer-INAO is a simple application that enables users to send personalized emails to a list of recipients through an intuitive command-line interface.

## 🚀 Quick Start

```bash
# Install
pip install emailer-inao

# Create campaign
emailer-inao config create /path/to/campaign

# Configure email
emailer-inao config smtp

# Test first
emailer-inao send --dry-run

# Send emails
emailer-inao send
```

## 📚 Complete Documentation

**Choose your language:**

- 🇺🇸 **[English Documentation](DOCUMENTATION_EN.md)** - Complete user guide in English
- 🇫🇷 **[Documentation Française](DOCUMENTATION_FR.md)** - Guide utilisateur complet en français
- 📋 **[Documentation Index](DOCUMENTATION.md)** - Language selection and quick reference

## ✨ Key Features

- **Email Personalization**: Use CSV data to customize emails with `{{variables}}`
- **Rich Text Support**: Create formatted emails with .docx files
- **Picture Generation**: Generate personalized images with text and graphics
- **Attachments**: Add files to all emails in a campaign
- **Dry Run Testing**: Preview emails as .eml files before sending
- **Campaign Management**: Organize campaigns in folders
- **Cross-Platform**: Works on Windows, Mac, and Linux

## 🎯 Perfect For

- Event invitations with personal details
- Newsletters with recipient names  
- Business communications to multiple clients
- Marketing campaigns with personalized images
- Any email requiring personal information for each recipient

## 📁 Campaign Structure

```
My Campaign/
├── recipients.csv          # Email list with data
├── subject.txt            # Email subject line
├── msg.txt or msg.docx    # Email message (plain or formatted)
├── attachments/           # Files to attach (optional)
└── picture-generator/     # Personalized images (optional)
```

## 🔧 System Requirements

- Python 3.8 or higher
- Internet connection for sending emails
- 512MB available RAM
- 100MB storage space

## 📖 Documentation

For complete installation instructions, user guides, troubleshooting, and advanced features, please refer to the documentation in your preferred language:

- **[DOCUMENTATION.md](DOCUMENTATION.md)** - Start here for language selection
- **[DOCUMENTATION_EN.md](DOCUMENTATION_EN.md)** - Complete English guide
- **[DOCUMENTATION_FR.md](DOCUMENTATION_FR.md)** - Guide complet en français

## 🆘 Quick Help

```bash
emailer-inao --help           # General help
emailer-inao config --help    # Campaign management help
emailer-inao send --help      # Email sending help
emailer-inao picture --help   # Picture generation help
```

## ⚡ Performance

- **Picture Generation**: 180 images/second
- **Email Processing**: 478 emails/second  
- **Recommended**: Up to 100 recipients per campaign

## 🛡️ Security

- Email passwords encrypted and stored locally only
- No data sent to external servers except for email delivery
- All processing happens on your computer

---

**Get started now**: Read the [complete documentation](DOCUMENTATION.md) in your language!

*Emailer-INAO - Making personalized email campaigns simple and accessible.*