Sable includes several improvements to notifications over the Cinny base it was forked from.

Privacy-First Push Notifications

When push notifications are enabled, Sable uses the event_id_only pusher format. This means your homeserver sends only the room ID and event ID to the push gateway (Sygnal) — no message content, sender name, or room name leaves your server unencrypted.

The service worker fetches the event details directly from your homeserver using your stored session, so the full notification (including sender name, room name, and message body) is assembled on your device rather than handled by a third party.

Encrypted Rooms

For end-to-end encrypted rooms, the service worker relays the encrypted event to an open Sable tab for decryption. If the app is currently visible, the OS notification is suppressed — you won't get a double alert.

Note: On iOS, encrypted message content in push notifications may work depending on the situation. When using a PWA, it will only work while the app is still running in the background — iOS aggressively suspends PWA processes, so if the PWA has been fully killed, encrypted content cannot be decrypted and the notification will show "Encrypted message" as the body. In a native browser (Safari), behaviour depends on whether a background tab is available. This is a platform limitation, not a Sable bug.

Using Your Own ntfy Server (Android)

Android can receive push notifications through an ntfy server you run, either with the built-in connection or with the ntfy app.

Built-in Connection

In Settings → Notifications → Notification transport, choose Built-in (WebSocket) and enter your server in ntfy server, e.g. https://ntfy.example.org. Leave it blank to use the server your Sable deployment ships with. The setting only applies to the current device.

ntfy App

Set your server as the default in the ntfy app, then choose UnifiedPush in Settings → Notifications → Notification transport and pick ntfy as the distributor.

Server Access

If your server uses auth-default-access: deny-all, allow anonymous access to the UnifiedPush topics (up*). The built-in connection subscribes without an account, so it needs read and write access:

ntfy access '*' 'up*' read-write

With the ntfy app signed in to your server, write-only is enough.

Notification Avatars

Push notifications now show the room avatar (or the sender's avatar for DMs) instead of always falling back to the Sable app logo.

DM Sidebar Avatars

When you have unread direct messages, the avatars of those contacts appear directly in the sidebar — up to three at a time, sorted by most recently active. Click an avatar to go straight to that DM.

The main DM icon in the sidebar only counts DMs that overflow beyond those three sidebar entries, so you won't see the same unread counted twice.

Reaction Notifications

Reactions to your messages now generate notifications. The notification preview shows the emoji that was used, e.g. "Reacted with 👍".

Encrypted Event Notifications

In-app notification banners and desktop notifications are now triggered correctly for messages in encrypted rooms, including when the app resumes from a background state.

Notification Settings Reference

Sable's notification behaviour is controlled by a combination of per-room settings and global toggles in Settings → Notifications.

Per-Room Notification Level

Each room can be set to one of three notification levels:

LevelUnread badgePush notificationIn-app banner
All messagesEvery unread messageEvery messageEvery message
Mentions & keywordsMentions/keywords onlyMentions/keywords onlyMentions/keywords only
MuteNoneNoneNone

The default for most rooms is Mentions & keywords. Direct messages default to All messages.

Badge Toggles

The Badges section in Settings → Notifications controls how unread counts appear in the sidebar. By default, DMs and mentions show a number count while rooms and spaces show a plain dot — the toggles below let you customise this.

Badge toggles in Settings → Notifications

ToggleDefaultWhat it does
Favicon Dot: Mentions OnlyOffWhen on, the browser tab favicon only changes for mentions or keyword alerts. Unreads in rooms set to "All messages" won't affect the favicon.
Show Room CountsOffWhen on, rooms and spaces show a number badge for total unread messages rather than a plain dot.
Show DM CountsOnShows a number badge on the DM section for unread direct messages. Turn off to show a plain dot instead.
Show Mention CountsOnShows a number badge for mentions and keyword alerts. Turn off to show a plain dot for those too.
Highlight MentionsOnHighlights the full message background when a message contains a mention or keyword, making it easier to spot at a glance.

Example combinations:

  • Default (Room Counts off, DM Counts on, Mention Counts on): DMs and mentions show a number, rooms show a plain dot — keeps the sidebar uncluttered while still surfacing important counts.
  • All counts on: Every section of the sidebar shows a number badge, giving you a precise overview at all times.
  • Favicon Dot: Mentions Only on: The browser tab icon only reacts to direct mentions, ignoring general unread activity — useful if you keep Sable open in a background tab and don't want constant favicon changes.

How Notifications Are Delivered

  • Push notifications (app closed / backgrounded): requires push to be enabled in Settings → Notifications. Follows per-room level.
  • In-app banners (app is open): shown in the top-right corner of the app. Also follows per-room level.
  • Unread badges (sidebar): controlled by the badge toggles above and per-room notification level.
  • DM sidebar avatars: contact avatars appear in the sidebar for unread DMs — see DM Sidebar Avatars above.