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