jarno
/
hydroxide-push
1
0
Fork 0
Code Issues Pull Requests Wiki Activity
Service adapted from https://github.com/emersion/hydroxide for receiving push notifications for Protonmail via ntfy.sh
116 Commits 2 Branches 7 Tags 13 MiB
Go 99.8%
Dockerfile 0.2%
Go to file
Brandon McDonnell 05ad63560f protonmail: Re-use local request variable in GetCurrentUser(). 2018-10-20 22:13:08 +00:00
auth Export RawAPIError so that encoding/json can set it, update AppVersion 2018-04-18 20:04:59 +01:00
carddav imap: add User.receiveEvents 2018-01-11 12:39:32 +01:00
cmd/hydroxide new app version 2018-10-16 20:52:02 +02:00
events imap: poll events after mutating the mailbox 2018-01-13 11:35:10 +01:00
imap PM API: read field in messages name changed to unread 2018-10-19 17:51:01 +02:00
protonmail protonmail: Re-use local request variable in GetCurrentUser(). 2018-10-20 22:13:08 +00:00
smtp smtp: Add sender address to message. Protonmail now expects it. 2018-10-20 14:50:02 +00:00
.gitignore Add authentication, fixes #2 2017-09-09 15:37:03 +02:00
LICENSE Initial commit 2017-08-21 17:33:41 +02:00
README.md readme: add IMAP instructions 2018-01-13 11:40:21 +01:00
go.mod Update go-smtp 2018-03-10 22:43:47 +01:00

README.md

hydroxide

A third-party, open-source ProtonMail bridge. For power users only, designed to run on a server.

hydroxide supports CardDAV, IMAP and SMTP.

Rationale:

  • No GUI, only a CLI (so it runs in headless environments)
  • Standard-compliant (we don't care about Microsoft Outlook)
  • Fully open-source

Setup

Go

hydroxide is implemented with Go. Head to Go website for setup information.

Install and Setup

Install hydroxide

go get github.com/emersion/hydroxide/cmd/hydroxide

Your credentials will be stored on disk encrypted with a 32-byte random password. When configuring your client, you'll need this password.

hydroxide auth <username>

Usage

hydroxide can be used in multiple modes.

CardDAV

You must setup an HTTPS reverse proxy to forward requests to hydroxide.

hydroxide carddav

Tested on GNOME (Evolution) and Android (DAVDroid).

IMAP

For now, it only supports unencrypted local connections.

hydroxide imap

SMTP

For now, it only supports unencrypted local connections.

hydroxide smtp

License

MIT