Skip to content

Configuration Guide ​

This guide explains all the configuration options available in PNotifier and provides examples for popular email providers.

SMTP Configuration ​

To forward SMS messages via email, PNotifier needs to know how to connect to your email provider's SMTP server. Here's what each setting means:

Basic SMTP Settings ​

  • SMTP Host: The address of your email provider's SMTP server
  • SMTP Port: The port number to use for the connection (typically 587 for TLS or 465 for SSL)
  • SMTP Username: Your email address or username for authentication
  • SMTP Password: Your email password or app-specific password
  • Email From: The sender address that will appear in the "From" field of forwarded emails
  • Email To: The recipient address where forwarded SMS messages will be sent

Security Considerations ​

Your SMTP credentials are stored securely on your device using Android DataStore. They are never transmitted to any external servers. For added security:

  • Use app-specific passwords when available (especially for Gmail)
  • Enable two-factor authentication on your email account
  • Regularly review which applications have access to your email account

Provider-Specific Examples ​

Gmail Configuration ​

For Gmail users, you'll need to use an app-specific password rather than your regular Gmail password:

To generate an app-specific password:

  1. Go to your Google Account settings
  2. Navigate to Security > 2-Step Verification > App passwords
  3. Generate a new app password for "Mail"
  4. Use this password in the SMTP Password field

Outlook/Hotmail Configuration ​

Yahoo Mail Configuration ​

Note: Yahoo requires app-specific passwords. Generate one in your Yahoo Account Security settings.

Custom SMTP Server ​

If you're using a custom email server or hosting provider:

  • SMTP Host: Your provider's SMTP server address
  • SMTP Port: The port specified by your provider (commonly 587 for TLS, 465 for SSL)
  • SMTP Username: Your full email address or username
  • SMTP Password: Your email password
  • Email From: Your email address
  • Email To: The destination email address

Advanced Settings ​

Automatically Ignore New Addresses ​

When enabled, this feature automatically adds new phone numbers to the ignored list. This is useful if you:

  • Receive spam SMS messages from unknown numbers
  • Want to minimize forwarded messages to only known contacts
  • Prefer to manually opt-in new numbers rather than opt-out

When disabled (default), all new numbers will be forwarded until you manually ignore them.

Use Address Book ​

When enabled, PNotifier will attempt to resolve phone numbers to contact names using your device's address book. This makes forwarded emails more readable by showing:

✉️ SMS from John Doe at 14:30

Instead of:

✉️ SMS from +1234567890 at 14:30

Note: This feature requires the READ_CONTACTS permission. You'll be prompted to grant this permission when enabling the setting.

Testing Your Configuration ​

After configuring your SMTP settings:

  1. Tap the "Save Configuration" button
  2. Tap "Forward Test Message"
  3. Check your email for a test message

If the test fails, double-check:

  • All fields are filled in correctly
  • Your SMTP credentials are valid
  • Your internet connection is working
  • Your email provider isn't blocking the connection

Common error messages and solutions:

  • "Authentication failed": Check your username and password
  • "Connection timed out": Verify the SMTP host and port
  • "STARTTLS failed": Try a different port or check your provider's TLS requirements