ntfy/docs/subscribe/pwa.md
2023-06-24 22:08:57 -04:00

2.8 KiB

Using the progressive web app (PWA)

While ntfy doesn't have a native desktop app, it is built as a progressive web app (PWA) and thus can be installed on both desktop and mobile devices.

This gives it its own launcher (e.g. shortcut on Windows, app on macOS, launcher shortcut on Linux, home screen icon on iOS, and launcher icon on Android), a standalone window, push notifications, and an app badge with the unread notification count.

Web app installation is supported on (see compatibility table for details):

  • Chrome on all platforms (Windows/Linux/macOS/Android/iOS)
  • Firefox on Android natively, and on Windows/Linux (via an extension)
  • Edge on Windows
  • Safari on macOS/iOS

Installation

Chrome/Safari on Desktop

To install and register the web app via Chrome, click the "install app" icon. After installation, you can find the app in your app drawer:

Chrome on Android

For Chrome on Android, either click the "Add to Home Screen" banner at the bottom of the screen, or select "install app" in the menu. After installation, you can find the app in your app drawer, and on your home screen.

Firefox on Android

XXXXXXXXXXX

Safari on iOS

On iOS Safari, tap on the Share menu > "Add to Home Screen".

XXXXXXx

Background notifications

Background notifications via web push are enabled by default and cannot be turned off when the app is installed, as notifications would not be delivered reliably otherwise. You can mute topics you don't want to receive notifications for.

On desktop, you generally need either your browser or the web app open to receive notifications, though the ntfy tab doesn't need to be open. On mobile, you don't need to have the web app open to receive notifications. Look at the web docs for a detailed breakdown.