diff --git a/docs/releases.md b/docs/releases.md index 6bf85041..02244300 100644 --- a/docs/releases.md +++ b/docs/releases.md @@ -8,6 +8,7 @@ and the [ntfy Android app](https://github.com/binwiederhier/ntfy-android/release **Features:** +* Support for ntfy:// deep links ([#20](https://github.com/binwiederhier/ntfy/issues/20), thanks to [@Copephobia](https://github.com/Copephobia) for reporting) * [Fastlane metadata](https://hosted.weblate.org/projects/ntfy/android-fastlane/) can now be translated too ([#198](https://github.com/binwiederhier/ntfy/issues/198), thanks to [@StoyanDimitrov](https://github.com/StoyanDimitrov) for reporting) diff --git a/docs/static/img/android-screenshot-share-1.jpg b/docs/static/img/android-screenshot-share-1.jpg new file mode 100644 index 00000000..503ce9f9 Binary files /dev/null and b/docs/static/img/android-screenshot-share-1.jpg differ diff --git a/docs/static/img/android-screenshot-share-2.jpg b/docs/static/img/android-screenshot-share-2.jpg new file mode 100644 index 00000000..b408f486 Binary files /dev/null and b/docs/static/img/android-screenshot-share-2.jpg differ diff --git a/docs/subscribe/phone.md b/docs/subscribe/phone.md index 74a105bb..66a42842 100644 --- a/docs/subscribe/phone.md +++ b/docs/subscribe/phone.md @@ -80,6 +80,35 @@ notifications. Firebase is overall pretty bad at delivering messages in time, bu The ntfy Android app uses Firebase only for the main host `ntfy.sh`, and only in the Google Play flavor of the app. It won't use Firebase for any self-hosted servers, and not at all in the the F-Droid flavor. +## Share to topic +You can share files to a topic using Android's "Share" feature. This works in almost any app that supports sharing files +or text, and it's useful for sending yourself links, files or other things. The feature remembers a few of the last topics +you shared content to and lists them at the bottom. + +The feature is pretty self-explanatory, and one picture says more than a thousand words. So here are two pictures: + +
+ + +
+ +## ntfy:// links +The ntfy Android app supports deep linking directly to topics. This is useful when integrating with [automation apps](#automation-apps) +such as [MacroDroid](https://play.google.com/store/apps/details?id=com.arlosoft.macrodroid) or [Tasker](https://play.google.com/store/apps/details?id=net.dinglisch.android.taskerm), +or to simply directly link to a topic from a mobile website. + +!!! info + Android deep linking of http/https links is very brittle and limited, which is why something like `https:////subscribe` is + **not possible**, and instead `ntfy://` links have to be used. More details in [issue #20](https://github.com/binwiederhier/ntfy/issues/20). + +**Supported link formats:** + +| Link format | Example | Description | +|-------------------------------------------------------------------------------|-------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `ntfy:///` | `ntfy://ntfy.sh/mytopic` | Directly opens the Android app detail view for the given topic and server. Subscribes to the topic if not already subscribed. This is equivalent to the web view `https://ntfy.sh/mytopic` (HTTPS!) | +| `ntfy:///?secure=false` | `ntfy://example.com/mytopic?secure=false` | Same as above, except that this will use HTTP instead of HTTPS as topic URL. This is equivalent to the web view `http://example.com/mytopic` (HTTP!) | + + ## Integrations ### UnifiedPush