UnifiedPush client library and distributor daemon.
How to register for push notifications:
- Register on D-Bus with a service name
- Make your application D-Bus activatable
- Create an instance of KUnifiedPush::Connector.
- Communicate the endpoint URL provided by this to the corresponding server-side application.
- Connect to its
For the basic functionality any standard compliant D-Bus distributor should work. The graphical status and configuration user interface however only works with the
kunifiedpush-distributor, as that needs a lot more access to distributor internal details than the standard interfaces provide.
UnifiedPush only specifies the protocol between distributor and client as well as between the server-side application and the push provider, but not the one between the push provider and the distributor. Supporting different push providers therefore requires provider specific code and configuration.
There is a configuration KCM, alternatively this can be configured via the
~/.config/KDE/kunifiedpush-distributor.conf configuration file.
Ntfy can be self-hosted, but also provides a hosted instance at
https://ntfy.sh that works without requiring an account.
In combination with our own distributor this allows configuring the push provider to use in System Settings, check the distributor status, and see all apps currently using push notifications.