Skip to main content

Super simple self-emailing.

Project description


A Python module to email myself from Python scripts and the command line.


$ pip install emailme

intended usage

emailme is intended to be used to quick-fire send an email to oneself from Python scripts and from the command line.

initial setup

Sending email requires you to login to an SMTP server. This often means a password is required.

To get started, you will need to store your username and password in a file that is read-write only by you. emailme provides a convenience way to get setup.

$ emailme start

You will be asked for your email address and passwrod there.

note about password: I strongly suggest NOT storing your regular email password. Instead, you should be using an app-specific password that you rotate regularly. Gmail offers such a functionality, and is highly recommended. Check with your email host provider for more detail.

Upon entering your credentials, a file will be written to disk at ~/.credentials/emailme.json. This email is only read/write-able by you; other users of the computer are unable to read or write it.

Upon this initial setup, you will now be able to use emailme to send emails to yourself.

command line usage

Usage at the command line is super simple.

$ emailme sendmail --subject "hey" --message "what's up?"

(be sure to escape your exclamation marks!)

script usage

You can also import emailme and use it from a Python script.

from emailme import sendmail

sendmail(subject='hey', message="What's up? How are you doing?")

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

emailme-0.3.0.tar.gz (4.2 kB view hashes)

Uploaded source

Built Distribution

emailme-0.3.0-py3-none-any.whl (5.4 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page