# Emailer Simple Tool
**Send personalized emails to multiple people easily and securely**
Emailer Simple Tool is a simple application that enables users to send personalized emails to a list of recipients through both command-line and graphical interfaces.
## 🚀 Quick Start
### **With Graphical Interface (Recommended for most users)**
```bash
# Install with GUI support
pip install emailer-simple-tool[gui]
# Launch graphical interface
emailer-simple-tool gui
```
### **Command Line Interface (For automation & advanced users)**
```bash
# Install CLI only
pip install emailer-simple-tool
# Create campaign
emailer-simple-tool config create /path/to/campaign
# Configure email
emailer-simple-tool config smtp
# Test first
emailer-simple-tool send --dry-run
# Send emails
emailer-simple-tool send
```
### **From Source Code**
```bash
# Clone/download source code, then:
cd emailer-simple-tool
pip install -e ".[gui]"
# Launch GUI
emailer-simple-tool gui
```
## 📚 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
- **Dual Interface**: Choose between graphical (GUI) or command-line (CLI) interface
- **🎨 Picture Generator Tab**: Complete GUI for creating personalized images with wizard-guided project creation
- **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 through intuitive GUI
- **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 with comprehensive GUI tools
- **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
## 🖥️ Interface Options
### **🎨 Graphical Interface (GUI)**
- **Perfect for**: Non-technical users, visual workflow
- **Features**: Point-and-click interface, visual previews, progress bars
- **Install**: `pip install emailer-simple-tool[gui]`
- **Launch**: `emailer-simple-tool gui`
### **⌨️ Command Line Interface (CLI)**
- **Perfect for**: Automation, scripting, advanced users
- **Features**: Fast execution, scriptable, server-friendly
- **Install**: `pip install emailer-simple-tool`
- **Usage**: `emailer-simple-tool config create /path/to/campaign`
## 📁 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:
- **[INSTALLATION.md](INSTALLATION.md)** - Complete installation guide for all platforms
- **[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-simple-tool --help # General help
emailer-simple-tool config --help # Campaign management help
emailer-simple-tool send --help # Email sending help
emailer-simple-tool picture --help # Picture generation help
emailer-simple-tool gui # Launch graphical interface
```
## ⚡ 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 Simple Tool - Making personalized email campaigns simple and accessible.*
Raw data
{
"_id": null,
"home_page": "https://github.com/delhomaws/emailer-simple-tool",
"name": "emailer-simple-tool",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "INAO Team <contact@inao.org>",
"keywords": "email, campaign, personalization, bulk-email, marketing",
"author": "INAO Team",
"author_email": "INAO Team <contact@inao.org>",
"download_url": "https://files.pythonhosted.org/packages/51/d5/20c781267d2409bec6cda6aec6e5573beed8effb641bddb49fd9f482442c/emailer_simple_tool-10.0.8.tar.gz",
"platform": null,
"description": "# Emailer Simple Tool\n\n**Send personalized emails to multiple people easily and securely**\n\nEmailer Simple Tool is a simple application that enables users to send personalized emails to a list of recipients through both command-line and graphical interfaces.\n\n## \ud83d\ude80 Quick Start\n\n### **With Graphical Interface (Recommended for most users)**\n```bash\n# Install with GUI support\npip install emailer-simple-tool[gui]\n\n# Launch graphical interface\nemailer-simple-tool gui\n```\n\n### **Command Line Interface (For automation & advanced users)**\n```bash\n# Install CLI only\npip install emailer-simple-tool\n\n# Create campaign\nemailer-simple-tool config create /path/to/campaign\n\n# Configure email\nemailer-simple-tool config smtp\n\n# Test first\nemailer-simple-tool send --dry-run\n\n# Send emails\nemailer-simple-tool send\n```\n\n### **From Source Code**\n```bash\n# Clone/download source code, then:\ncd emailer-simple-tool\npip install -e \".[gui]\"\n\n# Launch GUI\nemailer-simple-tool gui\n```\n\n## \ud83d\udcda Complete Documentation\n\n**Choose your language:**\n\n- \ud83c\uddfa\ud83c\uddf8 **[English Documentation](DOCUMENTATION_EN.md)** - Complete user guide in English\n- \ud83c\uddeb\ud83c\uddf7 **[Documentation Fran\u00e7aise](DOCUMENTATION_FR.md)** - Guide utilisateur complet en fran\u00e7ais\n- \ud83d\udccb **[Documentation Index](DOCUMENTATION.md)** - Language selection and quick reference\n\n## \u2728 Key Features\n\n- **Dual Interface**: Choose between graphical (GUI) or command-line (CLI) interface\n- **\ud83c\udfa8 Picture Generator Tab**: Complete GUI for creating personalized images with wizard-guided project creation\n- **Email Personalization**: Use CSV data to customize emails with `{{variables}}`\n- **Rich Text Support**: Create formatted emails with .docx files\n- **Picture Generation**: Generate personalized images with text and graphics through intuitive GUI\n- **Attachments**: Add files to all emails in a campaign\n- **Dry Run Testing**: Preview emails as .eml files before sending\n- **Campaign Management**: Organize campaigns in folders with comprehensive GUI tools\n- **Cross-Platform**: Works on Windows, Mac, and Linux\n\n## \ud83c\udfaf Perfect For\n\n- Event invitations with personal details\n- Newsletters with recipient names \n- Business communications to multiple clients\n- Marketing campaigns with personalized images\n- Any email requiring personal information for each recipient\n\n## \ud83d\udda5\ufe0f Interface Options\n\n### **\ud83c\udfa8 Graphical Interface (GUI)**\n- **Perfect for**: Non-technical users, visual workflow\n- **Features**: Point-and-click interface, visual previews, progress bars\n- **Install**: `pip install emailer-simple-tool[gui]`\n- **Launch**: `emailer-simple-tool gui`\n\n### **\u2328\ufe0f Command Line Interface (CLI)**\n- **Perfect for**: Automation, scripting, advanced users\n- **Features**: Fast execution, scriptable, server-friendly\n- **Install**: `pip install emailer-simple-tool`\n- **Usage**: `emailer-simple-tool config create /path/to/campaign`\n\n## \ud83d\udcc1 Campaign Structure\n\n```\nMy Campaign/\n\u251c\u2500\u2500 recipients.csv # Email list with data\n\u251c\u2500\u2500 subject.txt # Email subject line\n\u251c\u2500\u2500 msg.txt or msg.docx # Email message (plain or formatted)\n\u251c\u2500\u2500 attachments/ # Files to attach (optional)\n\u2514\u2500\u2500 picture-generator/ # Personalized images (optional)\n```\n\n## \ud83d\udd27 System Requirements\n\n- Python 3.8 or higher\n- Internet connection for sending emails\n- 512MB available RAM\n- 100MB storage space\n\n## \ud83d\udcd6 Documentation\n\nFor complete installation instructions, user guides, troubleshooting, and advanced features, please refer to the documentation in your preferred language:\n\n- **[INSTALLATION.md](INSTALLATION.md)** - Complete installation guide for all platforms\n- **[DOCUMENTATION.md](DOCUMENTATION.md)** - Start here for language selection\n- **[DOCUMENTATION_EN.md](DOCUMENTATION_EN.md)** - Complete English guide\n- **[DOCUMENTATION_FR.md](DOCUMENTATION_FR.md)** - Guide complet en fran\u00e7ais\n\n## \ud83c\udd98 Quick Help\n\n```bash\nemailer-simple-tool --help # General help\nemailer-simple-tool config --help # Campaign management help\nemailer-simple-tool send --help # Email sending help\nemailer-simple-tool picture --help # Picture generation help\nemailer-simple-tool gui # Launch graphical interface\n```\n\n## \u26a1 Performance\n\n- **Picture Generation**: 180 images/second\n- **Email Processing**: 478 emails/second \n- **Recommended**: Up to 100 recipients per campaign\n\n## \ud83d\udee1\ufe0f Security\n\n- Email passwords encrypted and stored locally only\n- No data sent to external servers except for email delivery\n- All processing happens on your computer\n\n---\n\n**Get started now**: Read the [complete documentation](DOCUMENTATION.md) in your language!\n\n*Emailer Simple Tool - Making personalized email campaigns simple and accessible.*\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A personalized email campaign management tool",
"version": "10.0.8",
"project_urls": {
"Bug Tracker": "https://github.com/delhomaws/emailer-simple-tool/issues",
"Changelog": "https://github.com/delhomaws/emailer-simple-tool/blob/main/CHANGELOG.md",
"Documentation": "https://github.com/delhomaws/emailer-simple-tool#documentation",
"Homepage": "https://github.com/delhomaws/emailer-simple-tool",
"Repository": "https://github.com/delhomaws/emailer-simple-tool"
},
"split_keywords": [
"email",
" campaign",
" personalization",
" bulk-email",
" marketing"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "31e67a7ae978e9643495866c4794930211e16027e3f8aa87dfc3dd279a3cf9f4",
"md5": "82ca9637780c8c7b1f3c12115aaabd37",
"sha256": "acaf020fd6deb078e7846d44ab0dbd832a9ce8045824851b99f31951c759ec4f"
},
"downloads": -1,
"filename": "emailer_simple_tool-10.0.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "82ca9637780c8c7b1f3c12115aaabd37",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 170323,
"upload_time": "2025-08-18T16:23:54",
"upload_time_iso_8601": "2025-08-18T16:23:54.076684Z",
"url": "https://files.pythonhosted.org/packages/31/e6/7a7ae978e9643495866c4794930211e16027e3f8aa87dfc3dd279a3cf9f4/emailer_simple_tool-10.0.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "51d520c781267d2409bec6cda6aec6e5573beed8effb641bddb49fd9f482442c",
"md5": "b3f3fbf60f45df6c536b5d7810acc68f",
"sha256": "2f78872115d95c0c015d1fbc857e80dc5deacfa72536fcf7c10eb154f38a5d1c"
},
"downloads": -1,
"filename": "emailer_simple_tool-10.0.8.tar.gz",
"has_sig": false,
"md5_digest": "b3f3fbf60f45df6c536b5d7810acc68f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 365988,
"upload_time": "2025-08-18T16:23:55",
"upload_time_iso_8601": "2025-08-18T16:23:55.340399Z",
"url": "https://files.pythonhosted.org/packages/51/d5/20c781267d2409bec6cda6aec6e5573beed8effb641bddb49fd9f482442c/emailer_simple_tool-10.0.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-18 16:23:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "delhomaws",
"github_project": "emailer-simple-tool",
"github_not_found": true,
"lcname": "emailer-simple-tool"
}
JSON
