ntfy 0.1.5

A utility for sending push notifications

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

Click here for full 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, but Mac OS X & Windows notifications won’t work.

Usage

# send a notification
ntfy send "Here's a notification!"

# send a notification with custom title (default is $USER@$HOST)
ntfy send -t 'ntfy' "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

• Pushover

• Pushbullet

• Linux Desktop Notifications (notify-send)

• Windows Desktop Notifications (requires PyWin32)

• Mac OS X Notification Center

ToDo

• Prowl

• Airgram

• Pushjet

• Pushalot

• Boxcar

• Instapush

Config

ntfy is configured via a json config file stored at ~/.ntfy.json. It requires at minimum 2 keys: backend & a config for that backend.

For full docs consult the wiki

Example Config

{
    "backend": "pushbullet",
    "pushbullet": {"access_token": "<redacted>"}
}