Skip to main content

A universal notification service

Project description

ap·prise / verb
To inform or tell (someone). To make one aware of something.

Apprise allows you to send a notification to *almost* all of the most popular notification services available to us today such as: Telegram, Pushbullet, Slack, Twitter, etc.

* One notification library to rule them all.
* A common and intuitive notification syntax.
* Supports the handling of images (to the notification services that will accept them).

System owners who wish to provide a notification service no longer need to research each and every new notification service as they come along. They just need to include this one library and then they can immediately gain access to a wide range of notifications services.

System Administrators who wish to send a notification from a scheduled task or from the command line also no longer need to find the right tool for the job. Everything is already wrapped and supported within the *apprise* script that ships with this product.

Supported Notifications
=======================
The section identifies all of the services supported by this script.

Popular Notification Services
-----------------------------
The table below identifies the services this tool supports and some example service urls you need to use in order to take advantage of it.
* Boxcar
boxcar://hostname
boxcar://hostname/@tag
boxcar://hostname/device_token
boxcar://hostname/device_token1/device_token2/device_tokenN
boxcar://hostname/@tag/@tag2/device_token

* Discord
discord://webhook_id/webhook_token
discord://avatar@webhook_id/webhook_token

* Emby
emby://user@hostname/
emby://user:password@hostname

* Faast
faast://authorizationtoken

* Growl
growl://hostname
growl://hostname:portno
growl://password@hostname
growl://password@hostname:port

Note: you can also use the get parameter version which can allow the growl request to behave using the older v1.x protocol. An example would look like:
growl://hostname?version=1

* IFTTT
ifttt://webhooksID/EventToTrigger
ifttt://webhooksID/EventToTrigger/Value1/Value2/Value3
ifttt://webhooksID/EventToTrigger/?Value3=NewEntry&Value2=AnotherValue

* Join
join://apikey/device
join://apikey/device1/device2/deviceN/
join://apikey/group
join://apikey/groupA/groupB/groupN
join://apikey/DeviceA/groupA/groupN/DeviceN/

* KODI
kodi://hostname
kodi://user@hostname
kodi://user:password@hostname:port

* Mattermost
mmost://hostname/authkey
mmost://hostname:80/authkey
mmost://user@hostname:80/authkey
mmost://hostname/authkey?channel=channel
mmosts://hostname/authkey
mmosts://user@hostname/authkey

* Prowl
prowl://apikey
prowl://apikey/providerkey

* Pushalot
palot://authorizationtoken

* PushBullet
pbul://accesstoken
pbul://accesstoken/#channel
pbul://accesstoken/A_DEVICE_ID
pbul://accesstoken/email@address.com
pbul://accesstoken/#channel/#channel2/email@address.net/DEVICE

* Pushjet
pjet://secret
pjet://secret@hostname
pjet://secret@hostname:port
pjets://secret@hostname
pjets://secret@hostname:port

Note: if no hostname defined https://api.pushjet.io will be used

* Pushover
pover://user@token
pover://user@token/DEVICE
pover://user@token/DEVICE1/DEVICE2/DEVICEN

* Rocket.Chat
rocket://user:password@hostname/RoomID/Channel
rockets://user:password@hostname:443/Channel1/Channel1/RoomID
rocket://user:password@hostname/Channel

* Slack
slack://TokenA/TokenB/TokenC/Channel
slack://botname@TokenA/TokenB/TokenC/Channel
slack://user@TokenA/TokenB/TokenC/Channel1/Channel2/ChannelN

* Stride
stride://auth_token/cloud_id/convo_id

* Super Toasty
toasty://user@DEVICE
toasty://user@DEVICE1/DEVICE2/DEVICEN

* Telegram
tgram://bottoken/ChatID
tgram://bottoken/ChatID1/ChatID2/ChatIDN

* Twitter
tweet://user@CKey/CSecret/AKey/ASecret

* XBMC
xbmc://hostname
xbmc://user@hostname
xbmc://user:password@hostname:port


* Windows Notifications
windows://

Email Support
-------------
* mailto://
mailto://userid:pass@domain.commailto://domain.com?user=userid&pass=password
mailto://domain.com:2525?user=userid&pass=password
mailto://user@gmail.com&pass=passwordmailto://userid:password@example.com?smtp=mail.example.com&from=noreply@example.com&name=no%20reply

* mailtos//
mailtos://userid:pass@domain.com
mailtos://domain.com?user=userid&pass=password
mailtos://domain.com:465?user=userid&pass=passwordmailtos://user@hotmail.com&pass=password
mailtos://userid:password@example.com?smtp=mail.example.com&from=noreply@example.com&name=no%20reply

Apprise have some email services built right into it (such as hotmail, gmail, etc) that greatly simplify the mailto:// service.

Custom Notifications
--------------------
* JSON
json://hostnamejson://user@hostname
json://user:password@hostname:port
json://hostname/a/path/to/post/to

* XML
xml://hostname
xml://user@hostname
xml://user:password@hostname:port
xml://hostname/a/path/to/post/to

Installation
============
The easiest way is to install from pypi:
pip install apprise

Command Line
============
A small command line tool is also provided with this package called apprise. If you know the server url's you wish to notify, you can simply provide them all on the command line and send your notifications that way:

Send a notification to as many servers as you want to specify
apprise -t 'my title' -b 'my notification body' \
'mailto://myemail:mypass@gmail.com' \
'pbul://o.gn5kj6nfhv736I7jC3cj3QLRiyhgl98b'

If you don't specify a --body (-b) then stdin is used allowing you to use the tool as part of your every day administration:
cat /proc/cpuinfo | apprise -t 'cpu info' \
'mailto://myemail:mypass@gmail.com'

Developers
==========
To send a notification from within your python application, just do the following:
import apprise

# Create an Apprise instance
apobj = apprise.Apprise()

# Add all of the notification services by their server url.

# A sample email notification
apobj.add('mailto://myemail:mypass@gmail.com')

# A sample pushbullet notification
apobj.add('pbul://o.gn5kj6nfhv736I7jC3cj3QLRiyhgl98b')

# Then notify these services any time you desire. The below would
# notify all of the services loaded into our Apprise object.
apobj.notify(
title='my notification title',
body='what a great notification service!',
)


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

apprise-0.5.2.zip (630.7 kB view details)

Uploaded Source

Built Distribution

apprise-0.5.2-py2.py3-none-any.whl (593.3 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file apprise-0.5.2.zip.

File metadata

  • Download URL: apprise-0.5.2.zip
  • Upload date:
  • Size: 630.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.9.1 pkginfo/1.3.2 requests/2.18.4 setuptools/39.2.0 requests-toolbelt/0.8.0 tqdm/4.19.6 CPython/3.6.5

File hashes

Hashes for apprise-0.5.2.zip
Algorithm Hash digest
SHA256 6d60aa16922f01d64135093aeadce43ca45097d9de5b8a80a06d12733e32c9d1
MD5 d800a3558ee4ff5b3cee72c78952a5f7
BLAKE2b-256 93b023a963fd7283a6583f98b8cfbe9143cc3abc07b6a8bb4d151dfc9eb14d5e

See more details on using hashes here.

File details

Details for the file apprise-0.5.2-py2.py3-none-any.whl.

File metadata

  • Download URL: apprise-0.5.2-py2.py3-none-any.whl
  • Upload date:
  • Size: 593.3 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.9.1 pkginfo/1.3.2 requests/2.18.4 setuptools/39.2.0 requests-toolbelt/0.8.0 tqdm/4.19.6 CPython/3.6.5

File hashes

Hashes for apprise-0.5.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 c9cb908ea7632f8342d5f11f80126ce6a8b3f3470b8bd259232062d746f7b424
MD5 a01abb7ba8eceb1d936bb0f658f4dba0
BLAKE2b-256 3d23e6f6c0b7ee6554e8c247a504090c3ba76347dbac9298ac754b88fb0fe2db

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page