A simple tool to make sending notifications to ntfy.sh or your self-hosted instance easy and clean.
Example: echo test failure | ntfyr -t test -s http://ntfy.sh -G skull,failure -T 'Bad thing happened!'
ntfyr [-h] [-A ACTIONS] [-X ATTACH] [-C CLICK] [-D DELAY] [-E EMAIL]
[-P {max,urgent,high,default,low,min,1,2,3,4,5}] [-G TAGS [TAGS ...]]
[-T TITLE] [-m MESSAGE] [--timestamp [TIMESTAMP]] -t TOPIC [-s SERVER]
[-u USER] [-p PASSWORD] [-o TOKEN] [-c CONFIG] [--debug] -t TOPIC, --topic TOPIC The topic to send the notification to. Required.
-s SERVER, --server SERVER The server to send the notification to. Defaults to https://ntfy.sh.
-u USER, --user USER The user to authenticate to the server with.
-p PASSWORD, --password PASSWORD The password to authenticate to the server with.
-o TOKEN, --token TOKEN The token to authenticate to the server with.
-c CONFIG [CONFIG ...], --config CONFIG [CONFIG ...] One or more configuration files with default values. The values in each file are merged onto the file after it (left to right) if more than one file is given. The values specified as arguments override the values in these files.
-m MESSAGE, --message MESSAGE The body of the message to send. The default (or if "-"is given) is to read from stdin.
--timestamp Add a timestamp to the message. If this argument is given without a value '%Y-%m-%d %H:%M:%S %Z' is used as the timestamp format. If the strig `%message` is in the format string it is replaced with the message after the timestamp is formatted.
-h, --help Show this help message and exit.
--debug Show extra information in the error messages.The following specify metadata (headers). See https://ntfy.sh/docs/publish/ for more information.
-A ACTIONS, --actions ACTIONS
-X ATTACH, --attach ATTACH
-C CLICK, --click CLICK
-D DELAY, --delay DELAY
-E EMAIL, --email EMAIL
-P {max,urgent,high,default,low,min,1,2,3,4,5}, --priority {max,urgent,high,default,low,min,1,2,3,4,5}
-G TAGS [TAGS ...], --tags TAGS [TAGS ...]
-T TITLE, --title TITLE- Install via pipx:
pipx install ntfyr
- Install system-wide with pipx:
PIPX_HOME=/opt/pipx PIPX_BIN_DIR=/usr/local/bin pipx install ntfyr
- Install manually:
git clone https://github.com/haxwithaxe/ntfyr.git cd ntfyr python3 setup.py install
No configuration is required. However a config file with default values can be given via -c path/to/config.ini, --config path/to/config.ini, or in the default location at /etc/ntfyr/config.ini.
Any of the long options (options beginning with --) without the leading dashes can be used to specify a default value for that option. For example the following sets a default server and credentials:
[ntfyr]
server = http://ntfy.example.com
user = alice
password = supersecret
timestamp = %%Y-%%m-%%d %%H:%%M:%%S %%Z
Commandline arguments override config values. Passing an option with an empty string will disable the default value in the config file. For example the following will disable the authentication that the above config enables:
ntfyr --user '' --password '' -t mytopic -m 'Hello world!'The timestamp option requires the % symbols to be escaped by doubling them (%%).
This module depends on requests and tzlocal.
