feat: Initial public repository with documentation
Added documentation for AutoMailSender Mac App Store submission: Files: - README.md - Project overview and quick start guide - PRIVACY_POLICY.md - Comprehensive privacy policy - SUPPORT.md - Support documentation with FAQ and troubleshooting Features documented: - Drag & drop file sending via SMTP - Multi-provider support (Gmail, Outlook, Yahoo, iCloud, Custom) - 26 language translations - macOS Keychain integration - Privacy-focused (no tracking, no data collection) - Built-in help system 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Nick Roodenrijs
230
PRIVACY_POLICY.md
Normal file
230
PRIVACY_POLICY.md
Normal file
@@ -0,0 +1,230 @@
|
|||||||
|
# AutoMailSender Privacy Policy
|
||||||
|
|
||||||
|
**Last Updated:** October 26, 2025
|
||||||
|
**Version:** 1.0.0
|
||||||
|
|
||||||
|
## Introduction
|
||||||
|
|
||||||
|
AutoMailSender is committed to protecting your privacy. This privacy policy explains what data we collect, how we use it, and your rights regarding your information.
|
||||||
|
|
||||||
|
## Data We Collect
|
||||||
|
|
||||||
|
AutoMailSender collects and stores the following data **locally on your Mac**:
|
||||||
|
|
||||||
|
### Email Configuration
|
||||||
|
- SMTP server settings (host, port, security settings)
|
||||||
|
- Email account username/address
|
||||||
|
- Email account credentials (stored securely in macOS Keychain)
|
||||||
|
- Selected email provider (Gmail, Outlook, Yahoo, iCloud, or Custom)
|
||||||
|
|
||||||
|
### Recipients
|
||||||
|
- Email addresses of recipients you configure
|
||||||
|
- Recipient names (if provided)
|
||||||
|
|
||||||
|
### Application Preferences
|
||||||
|
- Language preference
|
||||||
|
- Theme preference (light/dark/system)
|
||||||
|
- Default email subject and message templates
|
||||||
|
- Confirmation dialog preferences
|
||||||
|
- Sound preferences
|
||||||
|
|
||||||
|
### Usage Statistics
|
||||||
|
- Total number of emails sent (count only)
|
||||||
|
- Total number of files sent (count only)
|
||||||
|
- Last email sent timestamp
|
||||||
|
|
||||||
|
## How We Use Your Data
|
||||||
|
|
||||||
|
Your data is used **exclusively** for the following purposes:
|
||||||
|
|
||||||
|
1. **Sending Emails:** Credentials and SMTP settings are used to connect to your chosen email server and send emails on your behalf
|
||||||
|
2. **App Functionality:** Preferences and settings are used to customize your experience
|
||||||
|
3. **Statistics:** Basic usage counters help you track your email activity
|
||||||
|
|
||||||
|
## Data Storage & Security
|
||||||
|
|
||||||
|
### Local Storage Only
|
||||||
|
**ALL data is stored locally on your Mac.** We do not:
|
||||||
|
- Send data to any remote servers (except your SMTP server for email sending)
|
||||||
|
- Use cloud storage
|
||||||
|
- Sync data across devices
|
||||||
|
- Share data with third parties
|
||||||
|
|
||||||
|
### Storage Locations
|
||||||
|
- **Credentials:** macOS Keychain (system-level encrypted storage)
|
||||||
|
- **Settings & Preferences:** `~/Library/Application Support/AutoMailSender/config.json`
|
||||||
|
- **Logs:** `~/Library/Logs/AutoMailSender/` (no sensitive data logged)
|
||||||
|
|
||||||
|
### Encryption
|
||||||
|
- Email credentials are stored in macOS Keychain using system-level encryption
|
||||||
|
- Keychain data is protected by your Mac's security infrastructure
|
||||||
|
- No custom encryption keys or passwords are required
|
||||||
|
|
||||||
|
## Third-Party Data Sharing
|
||||||
|
|
||||||
|
**We DO NOT share your data with any third parties.** Specifically:
|
||||||
|
|
||||||
|
- ✅ **No analytics services** (Google Analytics, Mixpanel, etc.)
|
||||||
|
- ✅ **No advertising networks**
|
||||||
|
- ✅ **No crash reporting services**
|
||||||
|
- ✅ **No tracking pixels or cookies**
|
||||||
|
- ✅ **No social media integration**
|
||||||
|
- ✅ **No data brokers or resellers**
|
||||||
|
|
||||||
|
### The Only Exception: Your SMTP Server
|
||||||
|
|
||||||
|
When you send an email, AutoMailSender connects **directly** to your chosen SMTP server (e.g., smtp.gmail.com, smtp-mail.outlook.com). This connection is necessary to send emails and is subject to your email provider's privacy policy:
|
||||||
|
|
||||||
|
- [Gmail Privacy Policy](https://policies.google.com/privacy)
|
||||||
|
- [Outlook Privacy Policy](https://privacy.microsoft.com/privacystatement)
|
||||||
|
- [Yahoo Privacy Policy](https://legal.yahoo.com/privacy.html)
|
||||||
|
- [iCloud Privacy Policy](https://www.apple.com/legal/privacy/)
|
||||||
|
|
||||||
|
## Network Activity
|
||||||
|
|
||||||
|
AutoMailSender **only** makes network connections to:
|
||||||
|
|
||||||
|
1. **Your SMTP server** (as configured in settings) to send emails
|
||||||
|
2. **No other connections** - no analytics, no updates, no telemetry
|
||||||
|
|
||||||
|
All SMTP connections use industry-standard encryption (TLS/SSL) when supported by your email provider.
|
||||||
|
|
||||||
|
## Data Retention
|
||||||
|
|
||||||
|
Data is retained **indefinitely** until you:
|
||||||
|
|
||||||
|
1. **Manually delete it** through the app's settings
|
||||||
|
2. **Uninstall the app** (see Data Deletion below)
|
||||||
|
3. **Reset your Mac** or delete the Application Support folder
|
||||||
|
|
||||||
|
## Data Deletion
|
||||||
|
|
||||||
|
### How to Delete Your Data
|
||||||
|
|
||||||
|
**Option 1: Through the App**
|
||||||
|
- Open Settings → Email tab
|
||||||
|
- Clear credentials and recipients
|
||||||
|
- Your data will be removed from Keychain and local storage
|
||||||
|
|
||||||
|
**Option 2: Uninstall the App**
|
||||||
|
1. Move AutoMailSender.app to Trash
|
||||||
|
2. Delete `~/Library/Application Support/AutoMailSender/`
|
||||||
|
3. Keychain entries are automatically removed when the app is deleted
|
||||||
|
|
||||||
|
**Option 3: Manual Cleanup**
|
||||||
|
```bash
|
||||||
|
# Delete application data
|
||||||
|
rm -rf ~/Library/Application Support/AutoMailSender/
|
||||||
|
|
||||||
|
# Delete logs
|
||||||
|
rm -rf ~/Library/Logs/AutoMailSender/
|
||||||
|
|
||||||
|
# Remove Keychain entries (search for "AutoMailSender" in Keychain Access)
|
||||||
|
```
|
||||||
|
|
||||||
|
### What Happens After Deletion
|
||||||
|
Once deleted, your data **cannot be recovered**. We do not have backups of your data on any servers.
|
||||||
|
|
||||||
|
## Your Rights
|
||||||
|
|
||||||
|
Under applicable privacy laws (GDPR, CCPA, etc.), you have the right to:
|
||||||
|
|
||||||
|
1. **Access** your data (it's all in local files - see Storage Locations above)
|
||||||
|
2. **Correct** your data (edit through the app's settings)
|
||||||
|
3. **Delete** your data (see Data Deletion above)
|
||||||
|
4. **Export** your data (settings are stored in JSON format in `config.json`)
|
||||||
|
|
||||||
|
Since all data is stored locally on your Mac, you have full control and can exercise these rights at any time without contacting us.
|
||||||
|
|
||||||
|
## Children's Privacy
|
||||||
|
|
||||||
|
AutoMailSender does not knowingly collect information from children under 13. The app is rated 4+ and is suitable for all ages, but email functionality requires an SMTP account which typically requires users to be 13+.
|
||||||
|
|
||||||
|
## Changes to This Privacy Policy
|
||||||
|
|
||||||
|
We may update this privacy policy from time to time. Changes will be reflected in:
|
||||||
|
- The "Last Updated" date at the top of this document
|
||||||
|
- The app's version number
|
||||||
|
- Release notes for app updates
|
||||||
|
|
||||||
|
Continued use of AutoMailSender after changes constitutes acceptance of the updated policy.
|
||||||
|
|
||||||
|
## Open Source & Transparency
|
||||||
|
|
||||||
|
AutoMailSender's source code is available for review at:
|
||||||
|
**[GitHub Repository URL]** _(to be added when published)_
|
||||||
|
|
||||||
|
You can inspect the code to verify our privacy claims.
|
||||||
|
|
||||||
|
## Data Breach Notification
|
||||||
|
|
||||||
|
Since all data is stored locally on your Mac and we do not operate any servers:
|
||||||
|
|
||||||
|
- **We cannot be breached** - we don't have your data on our servers
|
||||||
|
- **Your data security** depends on your Mac's security (FileVault, password protection, etc.)
|
||||||
|
- **If your Mac is compromised**, change your email passwords immediately
|
||||||
|
|
||||||
|
## International Data Transfers
|
||||||
|
|
||||||
|
Since all data stays on your Mac:
|
||||||
|
- **No international transfers** occur (except SMTP connections to your email provider)
|
||||||
|
- **No cross-border data flow** to our servers (we have no servers)
|
||||||
|
- **Your data remains** in the country where your Mac is located
|
||||||
|
|
||||||
|
## Legal Basis for Processing (GDPR)
|
||||||
|
|
||||||
|
For users in the European Union, our legal basis for processing your data is:
|
||||||
|
|
||||||
|
1. **Contract Performance:** Necessary to provide email sending functionality
|
||||||
|
2. **Consent:** You provide explicit consent by configuring the app with your credentials
|
||||||
|
3. **Legitimate Interest:** Storing preferences improves user experience
|
||||||
|
|
||||||
|
## California Privacy Rights (CCPA)
|
||||||
|
|
||||||
|
For California residents:
|
||||||
|
- **Right to Know:** See "Data We Collect" section
|
||||||
|
- **Right to Delete:** See "Data Deletion" section
|
||||||
|
- **Right to Opt-Out:** Not applicable - we don't sell your data
|
||||||
|
- **Non-Discrimination:** Not applicable - app is free/single-price
|
||||||
|
|
||||||
|
## Contact Information
|
||||||
|
|
||||||
|
For privacy-related questions or concerns:
|
||||||
|
|
||||||
|
**Email:** nick@example.com
|
||||||
|
**Developer:** Nick Roodenrijs
|
||||||
|
**Response Time:** Typically within 48 hours
|
||||||
|
|
||||||
|
## Compliance Certifications
|
||||||
|
|
||||||
|
AutoMailSender complies with:
|
||||||
|
- ✅ Apple App Store Review Guidelines
|
||||||
|
- ✅ macOS App Sandbox requirements
|
||||||
|
- ✅ GDPR (EU General Data Protection Regulation)
|
||||||
|
- ✅ CCPA (California Consumer Privacy Act)
|
||||||
|
- ✅ Industry best practices for credential storage
|
||||||
|
|
||||||
|
## Technical Safeguards
|
||||||
|
|
||||||
|
We implement the following technical measures:
|
||||||
|
|
||||||
|
1. **Sandboxing:** App runs in macOS App Sandbox (restricted permissions)
|
||||||
|
2. **Keychain Encryption:** Credentials stored using macOS Keychain APIs
|
||||||
|
3. **No Plain-Text Passwords:** Passwords never stored in plain text
|
||||||
|
4. **Secure Connections:** TLS/SSL for SMTP connections
|
||||||
|
5. **Input Validation:** All user inputs are validated and sanitized
|
||||||
|
6. **No Logging of Sensitive Data:** Passwords and email content never logged
|
||||||
|
|
||||||
|
## Disclaimer
|
||||||
|
|
||||||
|
AutoMailSender is provided "as is" without warranties. You are responsible for:
|
||||||
|
- Maintaining the security of your Mac
|
||||||
|
- Keeping your email credentials secure
|
||||||
|
- Complying with your email provider's terms of service
|
||||||
|
- Using the app in accordance with applicable laws
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**By using AutoMailSender, you acknowledge that you have read and understood this privacy policy.**
|
||||||
|
|
||||||
|
For the full terms of service, see [TERMS_OF_SERVICE.md](./TERMS_OF_SERVICE.md).
|
||||||
233
README.md
Normal file
233
README.md
Normal file
@@ -0,0 +1,233 @@
|
|||||||
|
# AutoMailSender
|
||||||
|
|
||||||
|
**Simple, Secure Email Automation for macOS**
|
||||||
|
|
||||||
|
Send files via email with a simple drag-and-drop. AutoMailSender is a lightweight productivity tool designed for macOS users who regularly send files via SMTP.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ✨ Key Features
|
||||||
|
|
||||||
|
- **🎯 Drag & Drop Simplicity** - Drop files to send instantly
|
||||||
|
- **📧 Multi-Provider Support** - Gmail, Outlook, Yahoo, iCloud, Custom SMTP
|
||||||
|
- **👥 Bulk Recipients** - Send to multiple people simultaneously
|
||||||
|
- **🌍 26 Languages** - Full interface translation
|
||||||
|
- **🔒 Privacy-Focused** - No tracking, no ads, no data collection
|
||||||
|
- **🔐 Secure & Encrypted** - macOS Keychain integration, TLS/SSL
|
||||||
|
- **🌙 Dark Mode Compatible** - Seamless system appearance support
|
||||||
|
- **📚 Built-in Help** - Comprehensive SMTP setup guides
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📥 Download
|
||||||
|
|
||||||
|
**[Download from Mac App Store →](https://apps.apple.com/app/automailsender/idXXXXXXXXX)**
|
||||||
|
|
||||||
|
*Coming soon to the Mac App Store*
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🚀 Quick Start
|
||||||
|
|
||||||
|
1. **Install** AutoMailSender from the Mac App Store
|
||||||
|
2. **Open Settings** (⚙️ icon)
|
||||||
|
3. **Choose Email Provider** (Gmail, Outlook, etc.)
|
||||||
|
4. **Enter Credentials** (use app-specific password)
|
||||||
|
5. **Add Recipients**
|
||||||
|
6. **Drag & Drop Files** to send!
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎯 Perfect For
|
||||||
|
|
||||||
|
- 📸 **Photographers** - Share client galleries and proofs
|
||||||
|
- 💼 **Businesses** - Send invoices and documents
|
||||||
|
- 👨🏫 **Teachers** - Distribute course materials
|
||||||
|
- 🎨 **Designers** - Share mockups and assets
|
||||||
|
- 📄 **Anyone** - Regularly sending files via email
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🛡️ Privacy & Security
|
||||||
|
|
||||||
|
AutoMailSender takes your privacy seriously:
|
||||||
|
|
||||||
|
- ✅ **No tracking or analytics** - Zero telemetry
|
||||||
|
- ✅ **No ads** - No advertising networks
|
||||||
|
- ✅ **No data collection** - Everything stays on your Mac
|
||||||
|
- ✅ **macOS Keychain** - Secure credential storage
|
||||||
|
- ✅ **TLS/SSL Encryption** - Secure SMTP connections
|
||||||
|
- ✅ **App Sandbox** - Maximum security
|
||||||
|
|
||||||
|
**[Read Full Privacy Policy →](./PRIVACY_POLICY.md)**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📧 Supported Email Providers
|
||||||
|
|
||||||
|
| Provider | SMTP Server | Port | Security |
|
||||||
|
|----------|-------------|------|----------|
|
||||||
|
| Gmail | smtp.gmail.com | 587 | TLS |
|
||||||
|
| Outlook | smtp-mail.outlook.com | 587 | STARTTLS |
|
||||||
|
| Yahoo | smtp.mail.yahoo.com | 587 | TLS |
|
||||||
|
| iCloud | smtp.mail.me.com | 587 | TLS |
|
||||||
|
| Custom | Your server | Custom | TLS/SSL |
|
||||||
|
|
||||||
|
**Note:** App-specific passwords recommended for all providers.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📖 Documentation
|
||||||
|
|
||||||
|
- **[Privacy Policy](./PRIVACY_POLICY.md)** - How we handle your data
|
||||||
|
- **[Support Guide](./SUPPORT.md)** - Setup guides, FAQ, troubleshooting
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 💡 System Requirements
|
||||||
|
|
||||||
|
- macOS 12.0 (Monterey) or later
|
||||||
|
- SMTP-enabled email account
|
||||||
|
- Internet connection for sending emails
|
||||||
|
- 50 MB disk space
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🌍 Languages Supported
|
||||||
|
|
||||||
|
AutoMailSender is available in 26 languages:
|
||||||
|
|
||||||
|
English • Nederlands • Français • Deutsch • Español • Italiano • Português • Svenska • Dansk • Norsk • Suomi • Polski • Čeština • Русский • Ελληνικά • Türkçe • العربية • עברית • 简体中文 • 繁體中文 • 日本語 • 한국어 • ไทย • Tiếng Việt • Bahasa Indonesia
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📊 File Size Limits
|
||||||
|
|
||||||
|
| Provider | Maximum File Size |
|
||||||
|
|----------|------------------|
|
||||||
|
| Gmail | 25 MB |
|
||||||
|
| Outlook | 20 MB |
|
||||||
|
| Yahoo | 25 MB |
|
||||||
|
| iCloud | 20 MB |
|
||||||
|
| Custom SMTP | Depends on server |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ❓ FAQ
|
||||||
|
|
||||||
|
### Is AutoMailSender free?
|
||||||
|
Yes! Completely free with no in-app purchases or subscriptions.
|
||||||
|
|
||||||
|
### Does it collect my data?
|
||||||
|
No! Zero tracking, analytics, or data collection. Everything stays on your Mac.
|
||||||
|
|
||||||
|
### Can I send to multiple people?
|
||||||
|
Yes! Add multiple recipients in Settings → Recipients tab.
|
||||||
|
|
||||||
|
### What file types are supported?
|
||||||
|
All common file types except blocked executables (.exe, .bat, etc.) for security.
|
||||||
|
|
||||||
|
### Is my password secure?
|
||||||
|
Yes! Passwords are stored in macOS Keychain with system-level encryption.
|
||||||
|
|
||||||
|
**[See Full FAQ →](./SUPPORT.md#frequently-asked-questions-faq)**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🆘 Support
|
||||||
|
|
||||||
|
Need help? We're here for you:
|
||||||
|
|
||||||
|
- **📧 Email:** nick@example.com
|
||||||
|
- **📚 Documentation:** [SUPPORT.md](./SUPPORT.md)
|
||||||
|
- **⏱️ Response Time:** Within 48 hours
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📝 License
|
||||||
|
|
||||||
|
AutoMailSender is licensed under the MIT License.
|
||||||
|
|
||||||
|
```
|
||||||
|
MIT License
|
||||||
|
|
||||||
|
Copyright (c) 2025 Nick Roodenrijs
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
in the Software without restriction, including without limitation the rights
|
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is
|
||||||
|
furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all
|
||||||
|
copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||||
|
SOFTWARE.
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 👨💻 Developer
|
||||||
|
|
||||||
|
**Nick Roodenrijs**
|
||||||
|
|
||||||
|
- **Email:** nick@example.com
|
||||||
|
- **Repository:** https://git.plet.i234.me/Nick/automailsender-public
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎉 Acknowledgments
|
||||||
|
|
||||||
|
AutoMailSender is built with:
|
||||||
|
- [Electron](https://www.electronjs.org/) - Cross-platform desktop framework
|
||||||
|
- [Nodemailer](https://nodemailer.com/) - SMTP email sending
|
||||||
|
- macOS Keychain API - Secure credential storage
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⭐ Show Your Support
|
||||||
|
|
||||||
|
If you find AutoMailSender useful, please:
|
||||||
|
- ⭐ Star this repository
|
||||||
|
- 📢 Share with friends and colleagues
|
||||||
|
- ✍️ Leave a review on the Mac App Store
|
||||||
|
- 🐛 Report bugs or suggest features
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📜 Version History
|
||||||
|
|
||||||
|
### Version 1.0.0 (October 2025)
|
||||||
|
- Initial release
|
||||||
|
- Drag & drop file sending
|
||||||
|
- Multi-provider SMTP support
|
||||||
|
- Multiple recipients
|
||||||
|
- 26 language translations
|
||||||
|
- Dark mode support
|
||||||
|
- macOS Keychain integration
|
||||||
|
- Built-in help system
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Thank you for using AutoMailSender! 🚀**
|
||||||
|
|
||||||
|
*Sending files has never been simpler.*
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Links:**
|
||||||
|
- **Mac App Store:** Coming Soon
|
||||||
|
- **Privacy Policy:** [PRIVACY_POLICY.md](./PRIVACY_POLICY.md)
|
||||||
|
- **Support:** [SUPPORT.md](./SUPPORT.md)
|
||||||
|
- **Contact:** nick@example.com
|
||||||
360
SUPPORT.md
Normal file
360
SUPPORT.md
Normal file
@@ -0,0 +1,360 @@
|
|||||||
|
# AutoMailSender Support
|
||||||
|
|
||||||
|
**Version:** 1.0.0
|
||||||
|
**Last Updated:** October 27, 2025
|
||||||
|
|
||||||
|
## Get Help
|
||||||
|
|
||||||
|
If you need assistance with AutoMailSender, please use one of the following methods:
|
||||||
|
|
||||||
|
### 📧 Email Support
|
||||||
|
|
||||||
|
**Email:** nick@example.com
|
||||||
|
**Response Time:** Typically within 48 hours
|
||||||
|
|
||||||
|
### 📚 Built-in Help
|
||||||
|
|
||||||
|
AutoMailSender includes comprehensive help documentation:
|
||||||
|
1. Open AutoMailSender
|
||||||
|
2. Click Settings (⚙️ icon)
|
||||||
|
3. Click the Help button (? icon)
|
||||||
|
|
||||||
|
The built-in help includes:
|
||||||
|
- SMTP setup guides for Gmail, Outlook, Yahoo, and iCloud
|
||||||
|
- Troubleshooting common issues
|
||||||
|
- Privacy and security information
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Quick Start Guide
|
||||||
|
|
||||||
|
### 1️⃣ Initial Setup
|
||||||
|
|
||||||
|
1. **Open Settings** - Click the ⚙️ icon in the main window
|
||||||
|
2. **Choose Email Provider** - Select from:
|
||||||
|
- Gmail
|
||||||
|
- Outlook
|
||||||
|
- Yahoo Mail
|
||||||
|
- iCloud Mail
|
||||||
|
- Custom SMTP server
|
||||||
|
3. **Enter Credentials**:
|
||||||
|
- Email address
|
||||||
|
- App-specific password (recommended)
|
||||||
|
4. **Add Recipients** - Go to Recipients tab and add email addresses
|
||||||
|
|
||||||
|
### 2️⃣ Sending Files
|
||||||
|
|
||||||
|
1. **Drag & Drop** - Drag any file onto the main window
|
||||||
|
2. **Confirm** - Review the file and click "Send Email"
|
||||||
|
3. **Done!** - You'll see a success message
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Common Issues
|
||||||
|
|
||||||
|
### 🔐 Authentication Failed
|
||||||
|
|
||||||
|
**Problem:** "Authentication failed" error when sending emails
|
||||||
|
|
||||||
|
**Solutions:**
|
||||||
|
1. **Use App-Specific Password** instead of your regular password:
|
||||||
|
- **Gmail:** https://myaccount.google.com/apppasswords (requires 2FA)
|
||||||
|
- **Outlook:** https://account.microsoft.com/security (App passwords)
|
||||||
|
- **Yahoo:** https://login.yahoo.com/account/security (Generate app password)
|
||||||
|
- **iCloud:** https://appleid.apple.com (App-specific passwords)
|
||||||
|
|
||||||
|
2. **Check SMTP Settings**:
|
||||||
|
- Gmail: smtp.gmail.com, port 587, TLS
|
||||||
|
- Outlook: smtp-mail.outlook.com, port 587, STARTTLS
|
||||||
|
- Yahoo: smtp.mail.yahoo.com, port 587, TLS
|
||||||
|
- iCloud: smtp.mail.me.com, port 587, TLS
|
||||||
|
|
||||||
|
3. **Enable "Less Secure Apps"** (Gmail only, not recommended):
|
||||||
|
- Only if you can't use app-specific passwords
|
||||||
|
- Not available if 2FA is enabled
|
||||||
|
|
||||||
|
### 📁 File Too Large
|
||||||
|
|
||||||
|
**Problem:** "File size exceeds limit" error
|
||||||
|
|
||||||
|
**Solutions:**
|
||||||
|
1. **Check provider limits**:
|
||||||
|
- Gmail: 25 MB
|
||||||
|
- Outlook: 20 MB
|
||||||
|
- Yahoo: 25 MB
|
||||||
|
- iCloud: 20 MB
|
||||||
|
|
||||||
|
2. **Compress the file** using macOS Finder (Right-click → Compress)
|
||||||
|
3. **Use cloud storage** and send a link instead
|
||||||
|
|
||||||
|
### ❌ Connection Failed
|
||||||
|
|
||||||
|
**Problem:** "Connection to SMTP server failed"
|
||||||
|
|
||||||
|
**Solutions:**
|
||||||
|
1. **Check your internet connection**
|
||||||
|
2. **Verify SMTP server address and port**
|
||||||
|
3. **Check firewall settings** - Ensure outgoing connections on port 587/465 are allowed
|
||||||
|
4. **Try different security settings**:
|
||||||
|
- TLS (port 587)
|
||||||
|
- SSL (port 465)
|
||||||
|
- STARTTLS (port 587)
|
||||||
|
|
||||||
|
### 🔒 Keychain Access Denied
|
||||||
|
|
||||||
|
**Problem:** "Cannot access macOS Keychain"
|
||||||
|
|
||||||
|
**Solutions:**
|
||||||
|
1. **Allow Keychain Access**:
|
||||||
|
- Open Keychain Access app
|
||||||
|
- Find "AutoMailSender" entries
|
||||||
|
- Right-click → Get Info → Access Control
|
||||||
|
- Add AutoMailSender to "Always allow access"
|
||||||
|
|
||||||
|
2. **Reset Keychain** (last resort):
|
||||||
|
- Settings → Email tab → Clear credentials
|
||||||
|
- Re-enter your email and password
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## SMTP Setup Guides
|
||||||
|
|
||||||
|
### Gmail Setup
|
||||||
|
|
||||||
|
1. **Enable 2-Factor Authentication**:
|
||||||
|
- Go to https://myaccount.google.com/security
|
||||||
|
- Enable 2-Step Verification
|
||||||
|
|
||||||
|
2. **Generate App Password**:
|
||||||
|
- Visit https://myaccount.google.com/apppasswords
|
||||||
|
- Select "Mail" and "Mac" as device
|
||||||
|
- Copy the 16-character password
|
||||||
|
|
||||||
|
3. **Configure AutoMailSender**:
|
||||||
|
- Provider: Gmail
|
||||||
|
- Email: your-email@gmail.com
|
||||||
|
- Password: [16-character app password]
|
||||||
|
|
||||||
|
### Outlook/Hotmail Setup
|
||||||
|
|
||||||
|
1. **Enable 2-Step Verification**:
|
||||||
|
- Go to https://account.microsoft.com/security
|
||||||
|
- Enable two-step verification
|
||||||
|
|
||||||
|
2. **Generate App Password**:
|
||||||
|
- Visit https://account.microsoft.com/security
|
||||||
|
- Select "App passwords"
|
||||||
|
- Create new password for "Mail on Mac"
|
||||||
|
|
||||||
|
3. **Configure AutoMailSender**:
|
||||||
|
- Provider: Outlook
|
||||||
|
- Email: your-email@outlook.com (or @hotmail.com)
|
||||||
|
- Password: [app password]
|
||||||
|
|
||||||
|
### Yahoo Mail Setup
|
||||||
|
|
||||||
|
1. **Generate App Password**:
|
||||||
|
- Visit https://login.yahoo.com/account/security
|
||||||
|
- Click "Generate app password"
|
||||||
|
- Select "Other App" → name it "AutoMailSender"
|
||||||
|
|
||||||
|
2. **Configure AutoMailSender**:
|
||||||
|
- Provider: Yahoo
|
||||||
|
- Email: your-email@yahoo.com
|
||||||
|
- Password: [app password]
|
||||||
|
|
||||||
|
### iCloud Mail Setup
|
||||||
|
|
||||||
|
1. **Generate App-Specific Password**:
|
||||||
|
- Visit https://appleid.apple.com
|
||||||
|
- Sign in → Security section
|
||||||
|
- Generate Password → name it "AutoMailSender"
|
||||||
|
|
||||||
|
2. **Configure AutoMailSender**:
|
||||||
|
- Provider: iCloud
|
||||||
|
- Email: your-email@icloud.com (or @me.com)
|
||||||
|
- Password: [app-specific password]
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Frequently Asked Questions (FAQ)
|
||||||
|
|
||||||
|
### Is AutoMailSender free?
|
||||||
|
|
||||||
|
**Yes!** AutoMailSender is completely free with no in-app purchases, subscriptions, or hidden costs.
|
||||||
|
|
||||||
|
### Does AutoMailSender collect my data?
|
||||||
|
|
||||||
|
**No!** AutoMailSender:
|
||||||
|
- Does NOT collect analytics or telemetry
|
||||||
|
- Does NOT use tracking or advertising
|
||||||
|
- Does NOT upload your data to any servers (except your SMTP server)
|
||||||
|
- Stores all data locally on your Mac
|
||||||
|
- Uses macOS Keychain for secure credential storage
|
||||||
|
|
||||||
|
See [PRIVACY_POLICY.md](./PRIVACY_POLICY.md) for full details.
|
||||||
|
|
||||||
|
### Can I send to multiple recipients?
|
||||||
|
|
||||||
|
**Yes!** Add multiple recipients in Settings → Recipients tab. All recipients will receive the same file.
|
||||||
|
|
||||||
|
### What file types are supported?
|
||||||
|
|
||||||
|
AutoMailSender supports all common file types **except** blocked executable formats (.exe, .bat, .cmd, .com, .msi, .scr, .vbs, .js, .jar) for security reasons.
|
||||||
|
|
||||||
|
### What's the maximum file size?
|
||||||
|
|
||||||
|
File size limits depend on your email provider:
|
||||||
|
- **Gmail:** 25 MB
|
||||||
|
- **Outlook:** 20 MB
|
||||||
|
- **Yahoo:** 25 MB
|
||||||
|
- **iCloud:** 20 MB
|
||||||
|
- **Custom SMTP:** Depends on your server
|
||||||
|
|
||||||
|
### Can I customize the email subject and message?
|
||||||
|
|
||||||
|
**Yes!** Go to Settings → Email tab → scroll down to "Email Content" section. You can customize:
|
||||||
|
- Subject line
|
||||||
|
- Email body message
|
||||||
|
- Both support placeholders like {filename}
|
||||||
|
|
||||||
|
### Does AutoMailSender work offline?
|
||||||
|
|
||||||
|
**No.** AutoMailSender requires an internet connection to send emails via SMTP.
|
||||||
|
|
||||||
|
### Can I use AutoMailSender for bulk email marketing?
|
||||||
|
|
||||||
|
**No.** AutoMailSender is designed for personal/business file sharing, not mass marketing. Email providers enforce daily sending limits:
|
||||||
|
- Gmail: 500 emails/day
|
||||||
|
- Outlook: 300 emails/day
|
||||||
|
- Yahoo: 500 emails/day
|
||||||
|
|
||||||
|
Bulk email marketing violates most email providers' Terms of Service.
|
||||||
|
|
||||||
|
### Is my password stored securely?
|
||||||
|
|
||||||
|
**Yes!** AutoMailSender uses macOS Keychain to store credentials with system-level encryption. Passwords are never stored in plain text.
|
||||||
|
|
||||||
|
### Can I use AutoMailSender on multiple Macs?
|
||||||
|
|
||||||
|
**Yes!** However, settings do NOT sync between devices. You'll need to configure each Mac separately.
|
||||||
|
|
||||||
|
### Does AutoMailSender support Windows or Linux?
|
||||||
|
|
||||||
|
**No.** AutoMailSender is designed exclusively for macOS.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## System Requirements
|
||||||
|
|
||||||
|
- **macOS:** 12.0 (Monterey) or later
|
||||||
|
- **RAM:** 4 GB minimum
|
||||||
|
- **Disk Space:** 50 MB
|
||||||
|
- **Internet:** Required for sending emails
|
||||||
|
- **Email Account:** SMTP-enabled email account
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Privacy & Security
|
||||||
|
|
||||||
|
AutoMailSender is built with privacy and security as top priorities:
|
||||||
|
|
||||||
|
### 🔐 Security Features
|
||||||
|
|
||||||
|
- **macOS Keychain Integration** - Credentials encrypted at system level
|
||||||
|
- **App Sandbox** - Runs in restricted environment
|
||||||
|
- **TLS/SSL Encryption** - Secure SMTP connections
|
||||||
|
- **Input Validation** - Protects against injection attacks
|
||||||
|
- **No Plain-Text Passwords** - Passwords never stored in readable format
|
||||||
|
|
||||||
|
### 🛡️ Privacy Features
|
||||||
|
|
||||||
|
- **No Analytics** - Zero telemetry or tracking
|
||||||
|
- **No Advertising** - No ad networks or trackers
|
||||||
|
- **No Cloud Storage** - All data stays on your Mac
|
||||||
|
- **No Third Parties** - No data sharing with anyone
|
||||||
|
- **Open Source Ready** - Code available for inspection
|
||||||
|
|
||||||
|
Read the full [Privacy Policy](./PRIVACY_POLICY.md).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Feature Requests
|
||||||
|
|
||||||
|
Have an idea for AutoMailSender? Send your suggestions to:
|
||||||
|
|
||||||
|
**📧 Email:** nick@example.com
|
||||||
|
**Subject:** Feature Request - [Your Idea]
|
||||||
|
|
||||||
|
Please include:
|
||||||
|
- What feature you'd like to see
|
||||||
|
- Why it would be useful
|
||||||
|
- How you envision it working
|
||||||
|
|
||||||
|
We review all feature requests but cannot guarantee implementation.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Bug Reports
|
||||||
|
|
||||||
|
Found a bug? Please report it with the following information:
|
||||||
|
|
||||||
|
**📧 Email:** nick@example.com
|
||||||
|
**Subject:** Bug Report - [Brief Description]
|
||||||
|
|
||||||
|
**Include:**
|
||||||
|
1. macOS version (System Settings → About)
|
||||||
|
2. AutoMailSender version (Settings → About)
|
||||||
|
3. Steps to reproduce the bug
|
||||||
|
4. Expected behavior vs. actual behavior
|
||||||
|
5. Screenshots (if applicable)
|
||||||
|
6. Error messages (if any)
|
||||||
|
|
||||||
|
**Privacy Note:** Never include your email password in bug reports!
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
Interested in contributing to AutoMailSender?
|
||||||
|
|
||||||
|
- **Code Contributions:** Coming soon (open source plans)
|
||||||
|
- **Translations:** Email nick@example.com to help translate
|
||||||
|
- **Documentation:** Improvements to help docs welcome
|
||||||
|
- **Testing:** Beta testing opportunities available
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Legal
|
||||||
|
|
||||||
|
- **Privacy Policy:** [PRIVACY_POLICY.md](./PRIVACY_POLICY.md)
|
||||||
|
- **License:** MIT License
|
||||||
|
- **Copyright:** © 2025 Nick Roodenrijs. All rights reserved.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Version History
|
||||||
|
|
||||||
|
### Version 1.0.0 (Current)
|
||||||
|
- Initial release
|
||||||
|
- Drag & drop file sending
|
||||||
|
- Multi-provider SMTP support (Gmail, Outlook, Yahoo, iCloud, Custom)
|
||||||
|
- Multiple recipients
|
||||||
|
- 26 language translations
|
||||||
|
- Dark mode support
|
||||||
|
- macOS Keychain integration
|
||||||
|
- Built-in help system
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Useful Links
|
||||||
|
|
||||||
|
- **Privacy Policy:** https://git.plet.i234.me/Nick/automailsender-public/src/branch/main/PRIVACY_POLICY.md
|
||||||
|
- **Support:** mailto:nick@example.com
|
||||||
|
- **Mac App Store:** [App Store Link - Coming Soon]
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Thank you for using AutoMailSender! 🚀**
|
||||||
|
|
||||||
|
*Last updated: October 27, 2025*
|
||||||
Reference in New Issue
Block a user