A matrix-bridge written in Go to let you read and write your emails in matrix. You can have multiple emailaccounts in different private rooms and write emails to one or multiple recipients.
Matrix room: #jojiiMail:matrix.jojii.de
This bridge is currently in development. Its not 100% tested
You can run the install.sh to install it. If that doesn't work, use the steps below and contact me so I can fix it.
Clone this repository and run inside the folder
go get #fetch the required dependencies
and
go build -o emailbridge #compile it
Afterwards execute the created binary(./emailbridge
).
--> Configure
DockerHub: https://hub.docker.com/repository/docker/jojii/matrix_email_bridge
Run
docker pull jojii/matrix_email_bridge
to pull the image. Then create a container by running
docker run -d \
--restart unless-stopped \
-v `pwd`/data:/app/data \
--name email_bridge \
jojii/matrix_email_bridge
This will create and start a new Docker Container and create a new dir called 'data' in the current directory. In this folder data.db, cfg.json and the logs will be stored.
After configuring the bridge you have to run
docker start email_bridge #start the bridge
Note: 'localhost' as 'matrixserver' (in cfg.json) wouldn't work because of dockers own network. You have to specify the internal IP address of the matrix-synapse server!
You have to adjust the config file (cfg.json) to make it work with your matrix server.
Invite your bridge into a private room, it will join automatically.
If everything is set up correctly, you can bridge the room by typing !login
. Then you just have to follow the instructions. The command !help
shows a list with available commands.
Creating a new private room with the bot/bridge lets you add a different email account.
Using following command allows you to get an accesstoken for a given user:
curl -X POST -H "Content-Type:application/json" http://<domain>:8008/_matrix/client/r0/login -d '{"type":"m.login.password","identifier":{"type":"m.id.user","user":"<USERNAME>"},"password":"<PASSWORD>"}'
Note: you should change the permissions of the cfg.json
and data.db
to 640 or 660 because they contain sensitive data, not every user should be able to read them!
- Receiving Email with IMAPs
- Use custom IMAPs Server and port
- Use the bridge with multiple email addresses
- Use the bridge with multiple user
- Ignore SSL certs if required
- Detailed error codes/logging
- Use custom mailbox instead of INBOX
- Sending emails (to one or multiple participants)
- Use markdown (automatically translated to HTML) for writing emails (optional)
- Viewing HTML messages (as good as your matrix-client supports html)
- Attaching files sent into the bridged room
- Emailaddress blocklist (Ignore emails from given emailaddress)
- System to send passwords not in plaintext
- Add more header (CC/Bcc)
- Update the installerscript