1
0
Fork 0
mirror of https://github.com/binwiederhier/ntfy.git synced 2024-12-14 11:47:33 +00:00
binwiederhier-ntfy/docs/subscribe/web.md
2023-06-07 20:38:21 +02:00

3.7 KiB

Subscribe from the Web UI

You can use the Web UI to subscribe to topics as well. Simply type in the topic name and click the Subscribe button.

While subscribing, you have the option to enable desktop notifications, as well as background notifications. When you enable them for the first time, you will be prompted to allow notifications on your browser.

  • Sound only

    If you don't enable browser notifications, a sound will play when a new notification comes in, and the tab title will show the number of new notifications.

  • Browser Notifications

    This requires an active ntfy tab to be open to receive notifications. These are typically instantaneous, and will appear as a system notification. If you don't see these, check that your browser is allowed to show notifications (for example in System Settings on macOS).

    If you don't want to enable background notifications, pinning the ntfy tab on your browser is a good solution to leave it running.

  • Background Notifications

    This uses the Web Push API. You don't need an active ntfy tab open, but in some cases you may need to keep your browser open.

    Background notifications are only supported on the same server hosting the web app. You cannot use another server, but can instead subscribe on the other server itself.

    Browser Platform Browser Running Browser Not Running Restrictions
    Chrome Desktop
    Firefox Desktop
    Edge Desktop
    Opera Desktop
    Safari Desktop requires Safari 16.1, macOS 13 Ventura
    Chrome Android
    Safari iOS ⚠️ ⚠️ requires iOS 16.4, only when app is added to homescreen

    (Browsers below 1% usage not shown, look at the Push API for more info)

To learn how to send messages, check out the publishing page.

If topic reservations are enabled, you can claim ownership over topics and define access to it:

You can set your default choice for new subscriptions (for example synced account subscriptions and the default toggle state) in the settings page: