A utility for sending push notifications
Project description
About ntfy
ntfy is a command line utility (and to a degree, python library) for sending push notifications. It also can send a notification when a program finishes.
Unlike many existing utilities for Pushover or Pushbullet, it supports multiple backends.
Demo
Install
sudo pip install ntfy
Note: It is suggested to globally (as indicated above, without a virtualenv) install ntfy. It can be installed in a virtualenv, with caveats. Linux notifications requires --system-site-packages to be used and OS X notifications don’t work at all.
Usage
# send a notification ntfy send "Here's a notification!" # send a notification with custom title (default is $USER@$HOST) ntfy -t 'ntfy' send "Here's a notification with a custom title!" # send a notification when the command `sleep 10` finishes # this send the message '"sleep 10" succeeded in 0.2 minutes' ntfy done sleep 10
Backends
Supported
XMPP
Linux Desktop Notifications
Windows Desktop Notifications
Mac OS X Notification Center
ToDo
Config
ntfy is configured via a json config file stored at ~/.ntfy.json. It requires at minimum 1 keys: backends & a config for any backend that requires one.
For full docs consult the wiki
Example Config
{ "backends": ["pushbullet"], "pushbullet": {"access_token": "<redacted>"} }
Testing
python setup.py test
Contributors
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.