[GH-ISSUE #597] Support providing authentication details when using ntfy:// links #451

Open
opened 2026-05-07 00:24:18 +02:00 by BreizhHardware · 10 comments

Originally created by @laundmo on GitHub (Feb 1, 2023).
Original GitHub issue: https://github.com/binwiederhier/ntfy/issues/597

We'd like to use ntfy to notify end users, but getting them to configure the app is a lot of work to explain and get users to do.

Therefore, it would be really convenient to be able to provide users with ntfy:// links, which include the authentication details needed to actually subscribe to the topic.

Currently, if we use a ntfy:// link to a protected topic, it will register fine and will be stuck on reconnecting...constantly.

Proposed solutions:

  • UI popup asking for username/password when a ntfy:// link to a protected topic is used
  • ability to provide username/password inside a ntfy:// link (preferred)

Thank you for this project.

Originally created by @laundmo on GitHub (Feb 1, 2023). Original GitHub issue: https://github.com/binwiederhier/ntfy/issues/597 We'd like to use ntfy to notify end users, but getting them to configure the app is a lot of work to explain and get users to do. Therefore, it would be really convenient to be able to provide users with ntfy:// links, which include the authentication details needed to actually subscribe to the topic. Currently, if we use a ntfy:// link to a protected topic, it will register fine and will be stuck on `reconnecting...`constantly. Proposed solutions: - UI popup asking for username/password when a ntfy:// link to a protected topic is used - ability to provide username/password inside a ntfy:// link (preferred) Thank you for this project.
Author
Owner

@piwi82 commented on GitHub (Feb 6, 2023):

Therefore, users could scan a QR code to subscribe 📱
Making ntfy more accessible to end users will drive adoption 😎

<!-- gh-comment-id:1419150192 --> @piwi82 commented on GitHub (Feb 6, 2023): Therefore, users could scan a QR code to subscribe 📱 Making **ntfy** more accessible to end users will drive adoption 😎
Author
Owner

@dgtlmoon commented on GitHub (Nov 21, 2023):

theres a PR for QR codes on android over at https://github.com/binwiederhier/ntfy-android/pull/67

<!-- gh-comment-id:1821386802 --> @dgtlmoon commented on GitHub (Nov 21, 2023): theres a PR for QR codes on android over at https://github.com/binwiederhier/ntfy-android/pull/67
Author
Owner

@vovayartsev commented on GitHub (Dec 26, 2023):

A very wanted feature indeed!
💯 this great app could be used as a general reminder not only by technical users - if only the subscription setup was as easy as "scan the QR code".

Adding Deferred Deep Linking could automate the entire setup process to just 1 step:

example

Once this is in place, the officials can make their users' life so much easier in lots of annoying "in-real-world" scenarios:

  • tracking a mail delivery
  • tracking visa application process
  • queueing in a hospital/bank/etc
  • waiting for the order in McDonalds (QR code can be on a receipt)
<!-- gh-comment-id:1869820904 --> @vovayartsev commented on GitHub (Dec 26, 2023): A very wanted feature indeed! 💯 this great app could be used as a general reminder not only by technical users - if only the subscription setup was as easy as "scan the QR code". Adding [Deferred Deep Linking](https://www.branch.io/glossary/deferred-deep-linking/) could automate the entire setup process to just 1 step: ![example](https://github.com/binwiederhier/ntfy/assets/204231/38946fe2-0bdd-413f-ad0a-434b726d6300) Once this is in place, the officials can make their users' life so much easier in lots of annoying "in-real-world" scenarios: * tracking a mail delivery * tracking visa application process * queueing in a hospital/bank/etc * waiting for the order in McDonalds (QR code can be on a receipt)
Author
Owner

@FAUSheppy commented on GitHub (Feb 14, 2024):

This would be a great feature!

<!-- gh-comment-id:1943624270 --> @FAUSheppy commented on GitHub (Feb 14, 2024): This would be a great feature!
Author
Owner

@laundmo commented on GitHub (Aug 1, 2024):

@binwiederhier I would like to potentially add this feature, but spending the time to PR this hinges on whether you would accept a PR for it. Do you have any theoretical concerns with this feature?

<!-- gh-comment-id:2263173927 --> @laundmo commented on GitHub (Aug 1, 2024): @binwiederhier I would like to potentially add this feature, but spending the time to PR this hinges on whether you would accept a PR for it. Do you have any theoretical concerns with this feature?
Author
Owner

@Max-Github commented on GitHub (Mar 7, 2025):

I would be happy to also spend some time on this feature if the merge would considered.

<!-- gh-comment-id:2707126322 --> @Max-Github commented on GitHub (Mar 7, 2025): I would be happy to also spend some time on this feature if the merge would considered.
Author
Owner

@binwiederhier commented on GitHub (Dec 30, 2025):

This is very easy to add, but do people really want the ability to add username and password in a QR code? That seems like a recipe for disaster.

ntfy://ntfy.sh/mytopic?username=phil&password=ThisSeemsSafe

Image
<!-- gh-comment-id:3699630284 --> @binwiederhier commented on GitHub (Dec 30, 2025): This is very easy to add, but do people really want the ability to add username and password in a QR code? That seems like a recipe for disaster. ```ntfy://ntfy.sh/mytopic?username=phil&password=ThisSeemsSafe``` <img width="510" height="513" alt="Image" src="https://github.com/user-attachments/assets/cf498070-5391-4388-b032-0751291e5af5" />
Author
Owner

@laundmo commented on GitHub (Dec 30, 2025):

Yes(ish)

Its a better solution than having to teach non-technical users how to use ntfy, but the best solution that isn't unsafe would probably be single-use links. But that requires the app communicate with the server, and the server to expose a new unauthenticated endpoint.

Really, some way of making it easier for non-technical users to set up their phone to recieve private ntfy notifications would be great.

<!-- gh-comment-id:3699747812 --> @laundmo commented on GitHub (Dec 30, 2025): Yes(ish) Its a better solution than having to teach non-technical users how to use ntfy, but the best solution that isn't unsafe would probably be single-use links. But that requires the app communicate with the server, and the server to expose a new unauthenticated endpoint. Really, some way of making it easier for non-technical users to set up their phone to recieve private ntfy notifications would be great.
Author
Owner

@binwiederhier commented on GitHub (Dec 30, 2025):

Never in a million years would I have thought that non-technical users would want to use ntfy when I started making it. ntfy is about as nerdy as it gets, haha.

I get it though. It's not the first time I've heard it.

The ntfy:// links are pretty terrible to be honest, because if you don't have the app installed and you scan a QR code, it'll not work at all. I am toying with the idea of making a page "https://link.ntfy.sh/#subscribe=..." that will display steps of what to do, so that you can scan it with your normal camera and if you have the app, ntfy will open and subscribe, but if you don't it'll show instructions.

<!-- gh-comment-id:3699768233 --> @binwiederhier commented on GitHub (Dec 30, 2025): Never in a million years would I have thought that non-technical users would want to use ntfy when I started making it. ntfy is about as nerdy as it gets, haha. I get it though. It's not the first time I've heard it. The ntfy:// links are pretty terrible to be honest, because if you don't have the app installed and you scan a QR code, it'll not work at all. I am toying with the idea of making a page "https://link.ntfy.sh/#subscribe=..." that will display steps of what to do, so that you can scan it with your normal camera and if you have the app, ntfy will open and subscribe, but if you don't it'll show instructions.
Author
Owner

@laundmo commented on GitHub (Dec 30, 2025):

Never in a million years would I have thought that non-technical users would want to use ntfy when I started making it.

Well, want is relative. We want to direct our users away from using messangers as push notification platforms, and ntfy is a great alternative.

I am toying with the idea of making a page "https://link.ntfy.sh/#subscribe=..." that will display steps of what to do, so that you can scan it with your normal camera and if you have the app, ntfy will open and subscribe, but if you don't it'll show instructions.

That would be amazing!

<!-- gh-comment-id:3699789185 --> @laundmo commented on GitHub (Dec 30, 2025): > Never in a million years would I have thought that non-technical users would want to use ntfy when I started making it. Well, want is relative. We want to direct our users away from using messangers as push notification platforms, and ntfy is a great alternative. > I am toying with the idea of making a page "https://link.ntfy.sh/#subscribe=..." that will display steps of what to do, so that you can scan it with your normal camera and if you have the app, ntfy will open and subscribe, but if you don't it'll show instructions. That would be amazing!
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/ntfy#451
No description provided.