Update ToC for README.md
1 file changed
tree: a4dc01863e0465914e794ab665eedb97670fbd78
  1. .gitignore
  2. .goosarch
  3. .travis.yml
  4. .traviskey
  5. Dockerfile
  7. Makefile
  8. README.md
  9. VERSION.txt
  10. basic.mk
  11. filter.go
  12. gmail.go
  13. go.mod
  14. go.sum
  15. main.go
  16. vendor/
  17. version/


Travis CI GoDoc Github All Releases

A custom Gmail spam filter bot.

How it works

The bot will create 3 labels in your Gmail:

  • 1up/good: where you label emails that are “good”
  • 1up/bad: where you label emails that are “bad”
  • 1up/quarantine: where the bot will place emails that it thinks are “bad” based off the results of the Bayes classifier

Thanks to @brendandburns for pointing me at Bayes classifiers.



For installation instructions from binaries please visit the Releases Page.

You will want to follow the steps here to turn on the Gmail API and get a credentials file.

Via Go

$ go get github.com/genuinetools/1up

Via Docker

$ docker run --rm -it -v ~/configs/1up:/1up:ro \
    --tmpfs /tmp \
    r.j3ss.co/1up -f /1up/credentials.json


$ 1up -h
1up -  A custom Gmail spam filter bot.

Usage: 1up <command>


  -d, --debug       enable debug logging (default: false)
  -f, --creds-file  Gmail credential file (or env var GMAIL_CREDENTIAL_FILE) (default: <none>)
  -i, --interval    update interval (ex. 5ms, 10s, 1m, 3h) (default: 5m0s)
  --once            run once and exit, do not run as a daemon (default: false)


  version  Show the version information.