This is a tool for sending out multiple "personal" emails at the same time. They'll be sent from your personal Gmail account, and the recipient's name will be attached to the top of each email, so it looks like you hand wrote it (unless you inspect the email very closely).
Here's a screenshot:
Download the right
emailerbinary for your platform from the releases page, and copy it to the server.
config.ymland populate it with values that are appropriate - you'll need a Google Client ID and Secret.
Enable the GMail API for the project you created.
Add the groups of people you want to email. The
"First Last" <firstname.lastname@example.org>. You can also provide a plain email address -
opening_lineshould be the first line of the email to that person - "Dear X". We'll add the comma and the rest of the message. Here is an example:
groups: - id: sf-planning-commission name: SF Planning Commission recipients: - email: Rich Hillis <email@example.com> opening_line: Commissioner Hillis cc: - Planning Commission Secretary <firstname.lastname@example.org> - email: Dennis Richards <email@example.com> opening_line: Commissioner Richards - email: Rodney Fong <firstname.lastname@example.org> opening_line: Commissioner Fong - email: Christine Johnson <email@example.com> opening_line: Commissioner Johnson - email: Joel Koppel <firstname.lastname@example.org> opening_line: Commissioner Koppel - email: Myrna Melgar <email@example.com> opening_line: Commissioner Melgar - email: Kathrin Moore <firstname.lastname@example.org> opening_line: Commissioner Moore
Start the server:
emailer --config=/path/to/config.yml. That's it! Logs are sent to stderr and can be redirected from there.
Deploying to Google Cloud
./bin/gae-deploy. Google Cloud has trouble with the
Deploying to Other Platforms
You can download and install the binary directly:
curl --silent --location --output /usr/local/bin/emailer https://github.com/yimbycode/emailer/releases/download/1.7/emailer-linux-amd64 chmod 755 /usr/local/bin/emailer
/usr/local/bin/emailer in a directory with the config file and
the server should start as you expect.
You'll probably need to tweak the project to deploy to Heroku or elsewhere. I'd like to help make that feasible. Please contact me directly - email@example.com - for assistance.
When users visit the site they'll be redirected to a Google approval page. This page will ask them for permission to send emails on their behalf. Then they'll be redirected and can type away!