Description
Requires Crestron Home OS 4.12 or later.
The CPLLC ntfy Notifications is a Crestron Home tile that sends push notifications through ntfy, a free, open-source notification service, to every phone, tablet or computer subscribed to a topic in the free ntfy app. Its page holds up to 10 messages, each entered by the installer in one setting as name|icon|title|message|priority|tags|topic. Pressing a message, on the page or from a sequence, sends it and runs its “Pressed <name>” event, so any Crestron Home event, such as a door opening, a leak or an alarm, can send a notification.
Drivers->Notifications->Control Programming LLC->ntfy (Latest Release Notes) (Download Latest Version)
Windows utility that simplifies sideloading of drivers and extensions.
Valid Crestron Home icon names are listed here. All icon names begin with the letters “ic”, for example “icStop” or “icPlay”.
The extension’s own license key, a CPLLC Toolkit license key or a CPLLC site license key is entered in the extension’s Enter License Key option. The License Manager is not required, but it is the convenient place to enter a Toolkit or site license key once for every CPLLC driver it covers.
All license purchases are final and non-refundable. Every CPLLC driver works fully for two hours without a key: test it on your processor before you buy. See the Terms of Use.
Installer Options
- Obtain License Key – Opens CPLLC.net, where license keys and site licenses can be purchased.
- Enter License Key – The ntfy Notifications license key. Leave blank when the site has a CPLLC Toolkit or site license.
- Show on Home Screen – Shows the tile on the Home screen (default off).
- Show in Room Screen – Shows the tile in its room (default on).
- Starting Pin Code – A numeric PIN that must be entered before the messages are shown. Blank means no PIN (the default). A new Starting Pin Code replaces a PIN changed from the keypad, so a forgotten PIN can be reset here.
- Seconds Pin Active – How long the messages stay unlocked after the last touch (default 10 seconds; 0 also means 10).
- Tile Icon – The tile’s icon until the first message is sent (default icBroadcastRegular).
- Page Header Text – The control page’s title, and the tile’s status until the first message is sent. Blank shows “Notifications”.
- Message 01 – 10 – The message in one box, as Parameter 1|Parameter 2|Parameter 3|Parameter 4|Parameter 5|Parameter 6|Parameter 7: the name, shown on the page and naming its event and its entry in Select Message; the icon, by its name in the Crestron Home icon library; the title of the notification (blank: the topic name); the message text (blank: the name); the priority, 1 to 5 or min, low, default, high, urgent (blank: default); the tags, separated by commas, such as warning,house (emoji names show as emojis; see ntfy’s emoji list); and the topic (blank: the Topic option). Leave the box blank to hide the message. Give each message a different name: Select Message sends the first one with the name chosen.
- Server – The ntfy server. Blank (the default) uses the free public server, ntfy.sh; or enter the address of the owner’s own ntfy server, such as https://ntfy.example.com. An address that isn’t one shows Invalid Server.
- Topic – Required. The topic the messages go to, the same name the phones subscribe to in the ntfy app (see Installing): letters, numbers, – and _, up to 64. Any other shows Invalid Topic.
- Access Token – Only for a protected topic or a server that requires one: an ntfy access token (tk_…). Leave blank for ntfy.sh. One the server refuses shows Invalid Token.
Actions
- Select Message – Sends the message chosen from the list of message names, as a touch on the page does: it is sent through ntfy, its Pressed event runs and the tile shows it.
- Extension Enable / Extension Disable – Enables or disables the tile. A disabled tile shows Disabled and sends nothing.
Events
- Pressed <name> – The message was pressed, from the page or by Select Message, and queued to send.
- Extension Enabled / Extension Disabled – The tile was enabled or disabled.
- Pin Locked / Pin UnLocked – The PIN keypad locked again, or the right PIN was entered.
ntfy is a trademark of its owner. Crestron and Crestron Home are trademarks of Crestron Electronics, Inc. This extension is an independent product of Control Programming LLC and is not affiliated with, endorsed by or sponsored by the owner of ntfy.


