Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pushbits/server
A simple server for push notifications via Matrix (and a minimalistic alternative to Pushover and Gotify) 🚀📯
https://github.com/pushbits/server
cloud gotify matrix-org notifications privacy push-notifications pushbits pushnotification pushnotifications pushover self-hosted selfhosted selfhosting
Last synced: about 2 months ago
JSON representation
A simple server for push notifications via Matrix (and a minimalistic alternative to Pushover and Gotify) 🚀📯
- Host: GitHub
- URL: https://github.com/pushbits/server
- Owner: pushbits
- License: isc
- Created: 2020-07-25T22:32:28.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2023-12-21T23:29:03.000Z (9 months ago)
- Last Synced: 2024-04-12T00:10:35.202Z (5 months ago)
- Topics: cloud, gotify, matrix-org, notifications, privacy, push-notifications, pushbits, pushnotification, pushnotifications, pushover, self-hosted, selfhosted, selfhosting
- Language: Go
- Homepage: https://www.pushbits.io
- Size: 773 KB
- Stars: 291
- Watchers: 5
- Forks: 16
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-rainmana - pushbits/server - A simple server for push notifications via Matrix (and a minimalistic alternative to Pushover and Gotify) 🚀📯 (Go)
- awesome-starred - pushbits/server - A simple server for push notifications via Matrix (and a minimalistic alternative to Pushover and Gotify with a strong focus on security) 🚀📯 (self-hosted)
README
| :exclamation: **This software is currently in alpha phase.** |
|-----------------------------------------------------------------|
PushBits
Receive your important notifications immediately, over Matrix.
PushBits enables you to send push notifications via a simple web API, and delivers them to your users.
## 💡 About
PushBits is a relay server for push notifications.
It enables you to send notifications via a simple web API, and delivers them to you through [Matrix](https://matrix.org/).
This is similar to what [Pushover](https://pushover.net/) and [Gotify](https://gotify.net/) offer, but it does not require an additional app.
The vision is to have compatibility with Gotify on the sending side, while on the receiving side an established service is used.
This has the advantages that we need to maintain neither plugins (like those for [Watchtower](https://containrrr.dev/watchtower/) and [Jellyfin](https://jellyfin.org/)) nor clients.
## 🤘 Features
- [x] Multiple users and multiple channels (applications) per user
- [x] Compatibility with Gotify's API for sending messages
- [x] API and CLI for managing users and applications
- [x] Optional check for weak passwords using [HIBP](https://haveibeenpwned.com/)
- [x] Argon2 as KDF for password storage
- [ ] Two-factor authentication, [issue](https://github.com/pushbits/server/issues/19)
- [ ] Bi-directional key verification, [issue](https://github.com/pushbits/server/issues/20)
## 👮 License and Acknowledgments
Please refer to [the LICENSE file](LICENSE) to learn more about the license of this code.
It applies only where not specified differently.
The idea for this software was inspired by [Gotify](https://gotify.net/).
## 💻 Development and Contributions
The source code is located [on GitHub](https://github.com/pushbits/server).
You can retrieve it by checking out the repository as follows:
```bash
git clone https://github.com/pushbits/server.git
```
:wrench: **Want to contribute?**
Before moving forward, please refer to [our contribution guidelines](CONTRIBUTING.md).
:mailbox: **Found a security vulnerability?**
Check [this document](SECURITY.md) for information on how you can bring it to our attention.
:star: **Like fancy graphs?** See [our stargazers over time](https://starchart.cc/pushbits/server).
## ❓ Frequently Asked Questions (FAQ)
### Why Matrix instead of X?
This project totally would've used Signal if it would offer a proper API.
Sadly, neither [Signal](https://signal.org/) nor [WhatsApp](https://www.whatsapp.com/) come with an API (at the time of writing) through which PushBits could interact.
In [Telegram](https://telegram.org/) there is an API to run bots, but these are limited in that they cannot create chats by themselves.
If you insist on going with Telegram, have a look at [telepush](https://github.com/muety/telepush).
The idea of a federated, synchronized but yet end-to-end encrypted protocol is awesome, but its clients simply aren't really there yet.
Still, if you haven't tried it yet, we'd encourage you to check it out.