♾️ NtfyToast ♾️

NtfyToast is a forked verison of SnoreToast which has been modified to fit a certain list of criteria, including notifications that do not time out.

This library is packaged with ntfy-desktop

• About
  • What is ntfy?
  • What is ntfy-desktop
  • What is ntfy-toast
• Features
• Usage
• CLI Arguments
  • Customizing App Name
    • Create App Shortcut
    • Call App
• Build

NtfyToast is a command line application capable of creating Windows Toast notifications on Windows 8 or later. This app is part of a family of applications called Ntfy or Notify.

ntfy.sh (pronounced "notify") is a simple HTTP-based pub-sub notification service. With ntfy, you can send notifications to your phone or desktop via scripts from any computer, without having to sign up or pay any fees. If you'd like to run your own instance of the service, you can easily do so since ntfy is open source.

NtfyDesktop allows you to access the official free / paid notification service ntfy.sh, or your own self-hosted version of ntfy from within a desktop application which utilizes Electron as the wrapper.

This version of ntfy-desktop is based on the package ntfy-electron created by xdpirate, however, this version brings some changes in functionality, as well as some additional edits that I personally needed.

NtfyToast (the app in this repo) is a notification system for Windows 10/11 which is used within ntfy-desktop to display notifications for users.

It is based on SnoreToast, but has been updated with numerous features.

• Single binary file which works with x32 and x64 bit operating systems
• New -persistent option which allows a notification to stay on a user's screen indefinitely until the user closes it.
• Many small bug fixes

When using the command-line to show notifications, you can push a notification by opening Command Prompt and running:

cd X:\path\to\ntfytoast

Then push a notification with:

ntfytoast.exe -t "Title" -m "Message"

To make a notification stay on screen until the user dismisses it, add -persistent.

ntfytoast.exe -t "Title" -m "Message" -persistent

To make a notifiation stay on-screen for 25 seconds, use -d long

ntfytoast.exe -t "Title" -m "Message" -d long

To make a notifiation stay on-screen for 7 seconds, use -d short

ntfytoast.exe -t "Title" -m "Message" -d short

Other available options are listed below within the section CLI Arguments.

Windows Toast notifications will show the name of the application calling the notification at the top of each popup. Out-of-box, the application name will be NtfyToast.

If you wish to brand notifications with your own application name, then there are a few steps you must complete.

You must create a windows shortcut (.lnk) within your windows Start Menu. This is a requirement by Microsoft.

NtfyToast includes a command which will help you create the shortcut link automatically. To do this, open Command Prompt and run the command:

ntfytoast.exe -install "MyApp\MyApp.lnk" "C:\path\to\myApp.exe" "My.APP_ID"

To get the appID for the application you want to use, you can open Powershell and run the command:

get-StartApps | Where-Object {$_.Name -like '*YourAppName*'}

In our example, we can run

get-StartApps | Where-Object {$_.Name -like '*Ntfytoast*'}

Which returns the following:

Name      AppID
----      -----
ntfytoast com.ntfytoast.id

This means that if I wanted to use NtfyToast as the app which sends notifications, my final command would be:

ntfytoast.exe -install "Ntfytoast\Ntfytoast.lnk" "C:\path\to\ntfytoast.exe" "com.ntfytoast.id"

When the .lnk is created, it will be placed in:

C:\Users\USER\AppData\Roaming\Microsoft\Windows\Start Menu\Programs

Now that you have your app shortcut created, you can simply call the app every time you want to send a notification using -appID. Remember to use your own app's id.

ntfytoast.exe -t "Notification" -m "This is a test message" -appID "com.ntfytoast.id"

If you do not specify -appID <your.app.id>, then NtfyToast will be used as the default.

These instructions are only for people who wish to make changes to the NtfyToast source code / commit changes to the repo via pull requests. If you have no interest in editing the source code, then you can skip this section.

The easiest way to build this package is to download the source and place it somewhere on your system. Then install Visual Studio and launch the application.

Go to File -> Open -> Folder.

Select the folder where you downloaded NtfyToast and open it. After a few moments, a few new folders will be created in your project directory:

• 📁 .vs
• 📁 out

You can now start writing your code. Once you are finished, you need to build the application in Visual Studio.

Your binary will be built and placed inside:

• project-folder/out/build/x64-Debug/bin/ntfytoast.exe