ntfy-real-time-client 0.0.3

file: ~/.zshrc or ~/.bashrc etc

export NTFY_SERVER_HOSTNAME="ntfy.yourdomain.comm"
export NTFY_TOPIC="general"
export NTFY_TOKEN="tk_mahb1gt0k3nz4321"

Then restart the shell.

Command line

Our command line ntfy-real-time-client still needs more functions, but we already have one. His whole interface is here.

ntfy-real-time-client json

This command outputs new received notifications and can be used to pipe for your own scripts to be processed.

Programatically

Here is an example script of how using decorators to use the lib. More examples will be added soon, as there are more decorators/functions to be used.

#!/usr/bin/env python

from subprocess import Popen

from ntfy_real_time_client import register_command
from ntfy_real_time_client import register_parser
from ntfy_real_time_client import NTFYClientRealTime


# Let's use a decorator to registrate a command function; it will be executed
# when a message with `mycmd_rawdata` as the first word is received. All
# the arguments, *ie.*, all the words in the notification, including
# `mycmd_rawdata` will be passed to ``*args``:

@register_command
def mycmd_rawdata(*args, raw_data=None):
    print("RAW DATA IS:", raw_data)

# this decorator register a parser which is executed for each new
# notification received; here we have two examples:

@register_parser
def my_notify_send_parser(raw_data=None):
    args_str = "notify-send \"{message}\"".format(message=raw_data["message"])
    Popen(args=args_str, shell=True)


@register_parser
def my_print_parser(raw_data=None):
    print("MESSAGE RECEIVED:", raw_data)

# this instantiates the NTFY websocket class and runs it
client = NTFYClientRealTime()
client.run_forever()

chmod +x notify.py
./notify.py

file: python-client.py

#!/usr/bin/env python

from subprocess import Popen

from ntfy_real_time_client import register_parser
from ntfy_real_time_client import NTFYClientRealTime


PERMANENT_NOTIFICATION = True  # should notifications stay until clicked?

# shows notifications on Desktop using `notify-send`

@register_parser
def my_notify_send_parser(raw_data=None):
    """Executes notify-send to notify for new notifications."""

    message = raw_data['message']
    title = raw_data['title'] if raw_data['title'] else '_'

    is_permanent = ["-t", "0"] if PERMANENT_NOTIFICATION else []

    args = ['notify-send', *is_permanent, title, message ]

    Popen(args=args)

# prints to the terminal

@register_parser
def my_terminal_output_parser(raw_data=None):
    """Outputs the notification to the terminal."""

    print(raw_data)

    message = raw_data['message']
    title = raw_data['title'] if raw_data['title'] else '_'

    print(f"{title}\n{message}", end="\n\n")

# this instantiates the NTFY websocket class and runs it:

client = NTFYClientRealTime()
client.run_forever()

Command line tool

Let’s use Python’s click to make a fancy interface to this program?