ksmtp 0.2.10

ksmtp
=====

**ksmtp** - Simple Python SMTP relay replacement for sendmail with SSL authentication

Useful for relaying all email through an account like Gmail, without the
messy configurations of Postfix / Sendmail.

Source
======

GitHub - https://github.com/oeey/ksmtp

PyPI
====

PyPI - https://pypi.python.org/pypi/ksmtp

pip install ksmtp

Usage
=====

1. pip install ksmtp

2. edit /etc/ksmtp.conf with your login credentials

3. (optional) create symlink to ksmtp to replace sendmail

```
ln -s `which ksmtp` /usr/sbin/sendmail
```

4. send test mail

```
ksmtp test@test.com
ksmtp test@test.com -s "some subject"
```

Code Usage
==========

Sample Python Code:

import ksmtp
ksmtp.send(to="test@test.com",
subject="subject",
body="some message")

Sample Config
=============

Warning: make sure to backup this configuraiton file! Python's pip will overwrite it on updates to this package.

/etc/ksmtp.conf:

```
[ksmtp]

## from email address
from = username@gmail.com

## user
user = username@gmail.com

## password
pass = password

## server
server = smtp.gmail.com

## port
port = 465
#port = 587

## secure
secure = ssl
#secure = tls


## default to email address (if none specified)
#to = user@domain.com

## default catch-all (always CC)
#catch-all = user@domain.com

## default subject
#subject = default test subject
```

Issues
======

Gmail:
If you get an "smtplib.SMTPAuthenticationError" and your credentials are
correct, you may need to "allow less secure apps access" to your account.
See https://support.google.com/accounts/answer/6010255