A simple server for push notifications via Matrix (and a minimalistic alternative to Pushover and Gotify with a strong focus on security) 🚀📯
Find a file
2020-07-31 20:04:33 +02:00
api Make hashing parameters configurable 2020-07-31 19:58:06 +02:00
authentication Make hashing parameters configurable 2020-07-31 19:58:06 +02:00
configuration Add configuration for HTTP and debug mode 2020-07-31 20:04:33 +02:00
database Make hashing parameters configurable 2020-07-31 19:58:06 +02:00
dispatcher Remove in-code todos and create issues for them 2020-07-27 01:12:58 +02:00
model Make hashing parameters configurable 2020-07-31 19:58:06 +02:00
router Add configuration for HTTP and debug mode 2020-07-31 20:04:33 +02:00
runner Add configuration for HTTP and debug mode 2020-07-31 20:04:33 +02:00
.dockerignore Add simplistic Dockerfile 2020-07-27 22:05:00 +02:00
.editorconfig Initialize repository 2020-07-26 00:32:13 +02:00
.gitignore Add configuration for Travis CI 2020-07-26 15:27:36 +02:00
.travis.yml Use more recent version of Go on Travis CI 2020-07-26 15:55:19 +02:00
app.go Add configuration for HTTP and debug mode 2020-07-31 20:04:33 +02:00
Dockerfile Add simplistic Dockerfile 2020-07-27 22:05:00 +02:00
go.mod Replace bcrypt with Argon2 2020-07-27 21:48:41 +02:00
go.sum Replace bcrypt with Argon2 2020-07-27 21:48:41 +02:00
LICENSE Initialize repository 2020-07-26 00:32:13 +02:00
Makefile Add configuration for Travis CI 2020-07-26 15:27:36 +02:00
README.md Reference plugins which will work with PushBits 2020-07-27 22:01:40 +02:00

Build status

About

PushBits is a relay server for push notifications. It enables your services to send notifications via a simple web API, and delivers them to you through various messaging services.

The vision is to have compatibility with Gotify on the sending side, while on the receiving side established services are used. This has the advantages that

  • sending plugins written for Gotify (like those for Watchtower and Jellyfin) as well as
  • receiving clients written for the messaging service can be reused.

For now, only the Matrix protocol is supported, but support for different services like Telegram could be added in the future. I am myself experimenting with Matrix currently because I like the idea of a federated, synchronized but still end-to-end encrypted protocol.

The idea for this software and most parts of the initial source are heavily inspired by Gotify. Many thanks to jmattheis for his well-structured code.

Usage

PushBits is meant to be self-hosted. You are advised to install PushBits behind a reverse proxy and enable TLS.

At the moment, there is no front-end implemented. New users and applications need to be created via the API. Details will be made available once the interface is more stable.

Development

PushBits is currently in alpha stage. The API is neither stable, nor is provided functionality guaranteed to work. Stay tuned! 😉