diff --git a/docs/google.md b/docs/google.md new file mode 100644 index 0000000..adf3de8 --- /dev/null +++ b/docs/google.md @@ -0,0 +1,20 @@ +# Running koushin with a Google account + +## Create an application password + +First, you'll need to obtain an application-specific password for koushin from +the [app passwords] page on your Google account. + +## Run koushin + +Start koushin with these upstream URLs: + + koushin imaps://imap.gmail.com smtps://smtp.gmail.com \ + carddavs://www.googleapis.com/carddav/v1/principals/YOUREMAIL/ + +Replace `YOUREMAIL` with your Google account's e-mail address. + +Once koushin is started, you can login with your e-mail address and the app +password. + +[app passwords]: https://security.google.com/settings/security/apppasswords diff --git a/go.mod b/go.mod index 378aa71..323f30e 100644 --- a/go.mod +++ b/go.mod @@ -25,3 +25,5 @@ require ( golang.org/x/sys v0.0.0-20200202164722-d101bd2416d5 // indirect layeh.com/gopher-luar v1.0.7 ) + +replace github.com/emersion/go-webdav => ../go-webdav