-
-
Notifications
You must be signed in to change notification settings - Fork 281
Auto Send System
Jo McMillan edited this page Nov 9, 2025
·
2 revisions
Currently only in :dev version
The Auto-Send System automatically delivers newly ingested books to users' eReaders via email, eliminating the need for manual downloads and transfers.
When books are added to your Calibre-Web Automated library, the Auto-Send System can automatically email them to users' registered eReader email addresses. This seamless integration ensures that new content appears on eReaders without any user intervention.
- 📥 Book Ingestion: When a new book is added to the library (via upload, import, or automated processes)
- ⏰ Processing Delay: The system waits for a configurable delay (default: 5 minutes) to allow for metadata fetching and processing
-
📧 Auto-Send Execution: Books are automatically sent to all users who have:
- Auto-send enabled in their profile
- A valid eReader email address configured
- The appropriate eReader format preference set
Users can enable auto-send in their profile settings:
- Navigate to User Profile → Edit Profile
- Check the "Auto-send books to eReader" checkbox
- Configure your eReader email address (e.g.,
[email protected]for Kindle) - Set your preferred eReader format (EPUB, MOBI, AZW3, etc.)
- Save your profile
Different eReader devices use different email addresses:
-
📖 Kindle:
[email protected](found in your Amazon account settings) - 🌊 Kobo: Usually your regular email address
- 📚 Other devices: Consult your device documentation
The system supports sending books in various formats:
- 📘 EPUB - Universal format, works with most eReaders
- 📕 MOBI - Kindle legacy format
- 📗 AZW3 - Kindle enhanced format
- 📙 KEPUB - Kobo enhanced format
- 📄 PDF - Universal document format
Administrators can configure the Auto-Send System in CWA Settings:
-
⏰ Auto-Send Delay: Time to wait before sending (1-60 minutes)
- Allows time for metadata processing and format conversion
- Default: 5 minutes
- Recommended: 5-10 minutes for optimal performance
The Auto-Send System uses Calibre-Web's existing email configuration:
- Navigate to Admin → Configuration → E-mail
- Configure SMTP settings:
- 🌐 SMTP Hostname: Your email provider's SMTP server
- 🔌 SMTP Port: Usually 587 for TLS or 465 for SSL
- 🔒 Encryption: Enable TLS or SSL
- 👤 SMTP Login: Your email address
- 🔑 SMTP Password: Your email password or app password
-
🌐 SMTP Hostname:
smtp.gmail.com -
🔌 SMTP Port:
587 - 🔒 Encryption: TLS
-
⚠️ Note: Use an app password, not your regular password
-
🌐 SMTP Hostname:
smtp-mail.outlook.com -
🔌 SMTP Port:
587 - 🔒 Encryption: TLS
-
🌐 SMTP Hostname:
smtp.mail.yahoo.com -
🔌 SMTP Port:
587or465 - 🔒 Encryption: TLS or SSL
Auto-send activates for:
- ✅ Newly uploaded books
- ✅ Books imported via automated processes
- ✅ Books added through the web interface
- ❌ Existing books (re-sending existing books requires manual action)
- 📥 Book Ingestion: Book is added to the library
- 🏷️ Metadata Processing: Auto-metadata fetch runs (if enabled)
- 🔄 Format Conversion: Auto-convert runs (if enabled and needed)
- ⏰ Delay Period: System waits for the configured delay
- 📧 Auto-Send: Books are sent to eligible users
A user receives auto-sent books when:
- ✅ Auto-send is enabled in their profile
- ✅ Valid eReader email address is configured
- ✅ User has access to the book (not restricted by tags, etc.)
- ✅ Book is available in user's preferred format (or convertible to it)
👤 Check User Settings:
- Verify auto-send is enabled in user profile
- Confirm eReader email address is correct
- Ensure preferred format is set
📧 Check Email Configuration:
- Test email settings in Admin → Configuration → E-mail
- Verify SMTP credentials are correct
- Check if email provider requires app passwords
📚 Check Book Status:
- Ensure book finished processing (metadata, conversion)
- Verify book is in user's preferred format
- Check if user has access permissions to the book
- Auto-send waits for the configured delay period
- Books may be queued if metadata fetching or conversion is running
- Check CWA Settings for current delay configuration
- If user's preferred format isn't available, check auto-convert settings
- Some formats may not be compatible with certain eReaders
- Consider setting up format conversion chains
- Use device-specific email addresses when available
- Choose formats optimized for your eReader
- Test with a single book before enabling for all content
- Set reasonable auto-send delays (5-10 minutes)
- Configure reliable email settings with proper authentication
- Monitor email sending limits from your provider
- Consider setting up dedicated email accounts for book sending
- Some providers have daily sending limits
- Use app passwords when required (Gmail, Yahoo, etc.)
- Consider using dedicated email services for high-volume sending
- Monitor spam folder in case emails are filtered
- Auto-send waits for metadata processing to complete
- Ensures books have proper titles and author information when sent
- Books are converted to user's preferred format before sending
- Auto-send waits for conversion to complete
- Works seamlessly with automated book ingestion
- Processes books from watch folders, imports, and uploads
- User preferences stored in
usertable - Send history tracked for troubleshooting
- Integration with existing Calibre-Web email system
- Auto-send runs as background tasks
- Queued to prevent overwhelming email servers
- Respects email provider rate limits
- Failed sends are logged for administrator review
- Automatic retry mechanisms for temporary failures
- User notification for persistent delivery issues
- 🔐 Email credentials are stored securely
- ✉️ User email addresses are validated
- 📚 Books are only sent to authenticated users
- 🛡️ Respects existing access controls and restrictions
🛠️ For technical support or feature requests, please refer to the project documentation or contact your system administrator.