matrix-doc/docs/notifications.md

title	date
Notifications	2021-08-03T20:30:00+02:00

Fine-tune notifications

You have to be able to do your work and not be disturbed by Matrix. In times of digital distraction, we all need to learn how notifications should be adapted step by step in a meaningful way.

Scenario 1

If you are writing a proposal for a research project and the deadline is approaching, you may want to be notified when your colleagues want to start a discussion with you. Notifications in this room are intended to draw attention and will be set accordingly...

Scenario 2

If you are in a room whose main purpose is to inform yourself about new scientific papers and other interesting things from time to time, you may want to turn off the notifications and remind yourself to enter the room from time to time, or you may want to be notified aloud only when your name is mentioned in the discussion.

Global settings

Settings > Notifications

Here experiences must be made if necessary, which help with the estimate, which notifications one really needs promptly and when a back-and-forth-looking is sufficient.

See recommendations for first steps after first login

Roomwise settings

When the mouse is moved over individual rooms in the room list, 3 grey dots appear on the right-hand edge for each room. After clicking on them, you can set up the notifications for each room individually.

using an alternative push gateway (ntfy)

ntfy (pronounce: notify) is a simple HTTP-based pub-sub notification service.

To make use of envs ntfy service, on Android for example, you need two things:

• the ntfy app
• a UnifiedPush-compatible matrix app

You need to install the ntfy app on each device on which you want to receive push notifications through your ntfy server. The ntfy app will provide UnifiedPush notifications to any number of UnifiedPush-compatible messaging apps installed on the same device.

Setting up the ntfy Android app

1. Install the ntfy Android app from F-droid or Google Play.
2. In its Settings -> General: Default server, enter your ntfy server URL, such as https://ntfy.envs.net.
3. In its Settings -> Advanced: Connection protocol, choose WebSockets.

That is all you need to do in the ntfy app. It has many other features, but for our purposes you can ignore them. In particular you do not need to follow any instructions about subscribing to a notification topic as UnifiedPush will do that automatically.

Setting up a UnifiedPush-compatible matrix app

Install any UnifiedPush-enabled matrix app on that same device. The matrix app will learn from the ntfy app that you have configured UnifiedPush on this device, and then it will tell your matrix server to use it.

Steps needed for specific matrix apps:

• FluffyChat-android:

  • Should auto-detect and use it. No manual settings.

• SchildiChat-android:

  • enable Settings -> Notifications -> UnifiedPush: Force custom push gateway.
  • choose Settings -> Notifications -> UnifiedPush: Re-register push distributor. (For info, a more complex alternative to achieve the same is: delete the relevant unifiedpush registration in ntfy app, force-close SchildiChat, re-open it.)
  • verify Settings -> Notifications -> UnifiedPush: Notification targets as described below in the "Troubleshooting" section.

• Element-android v1.4.26+:

  • choose Settings -> Notifications -> Notification method -> ntfy
  • verify Settings -> Troubleshoot -> Troubleshoot notification settings

If the matrix app asks, "Choose a distributor: FCM Fallback or ntfy", then choose "ntfy".

If the matrix app doesn't seem to pick it up, try restarting it and try the Troubleshooting section below.