Skip to content

CLI_Usage

Chris Caron edited this page Sep 30, 2019 · 21 revisions

Apprise CLI

This small tool wraps the apprise python library to allow individuals such as Developers, DevOps, and Administrators to send notifications from the command line.

Apprise in it's most basic form requires that you provide it a message and an Apprise URL which contains enough information to send the notification with.

# Set a notification to a hotmail (email) account:
python apprise --body="My Message" mailto://user:password@hotmail.com

If you don't specify a --body (-b) then Apprise reads from stdin instead:

# without a --body, you can use a pipe | to redirect output
# into you're notification:
uptime | python apprise mailto://user:password@hotmail.com

There is no limit to the number of services you want to notify, just keep adding/chaining them one after another:

# Set a notification to a yahoo email account, Slack, and a Kodi Server:
python apprise --body="Notify more than one service" \
   mailto://user:password@yahoo.com \
   slack://token_a/token_b/token_c \
   kodi://example.com
Clone this wiki locally