Send personal emails to your elected officials
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets
bin
static
templates
vendor
.gitignore
.travis.yml
CONTRIBUTING.md
Gopkg.lock
Gopkg.toml
LICENSE
Makefile
README.md
app.yaml
config.sample.yml
flash.go
form.go
main.go
main_appengine.go
main_noappengine.go
main_test.go
nopush.go
opaque.go
privacy-policy.md
push.go

README.md

emailer

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:

Installation

  • Add the groups of people you want to email. The email key should follow this format: "First Last" <email@domain.com>. You can also provide a plain email address - email@domain.com. The opening_line should 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 <richhillissf@yahoo.com>
              opening_line: Commissioner Hillis
              cc:
                - Planning Commission Secretary <commissions.secretary@sfgov.org>
            - email: Dennis Richards <dennis.richards@sfgov.org>
              opening_line: Commissioner Richards
            - email: Rodney Fong <planning@rodneyfong.com>
              opening_line: Commissioner Fong
            - email: Christine Johnson <christine.d.johnson@sfgov.org>
              opening_line: Commissioner Johnson
            - email: Joel Koppel <joel.koppel@sfgov.org>
              opening_line: Commissioner Koppel
            - email: Myrna Melgar <myrna.melgar@sfgov.org>
              opening_line: Commissioner Melgar
            - email: Kathrin Moore <kathrin.moore@sfgov.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

Run ./bin/gae-deploy. Google Cloud has trouble with the vendor directory.

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

Then run /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 - kev@inburke.com - for assistance.

Usage

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!