Skip to content

pushover-cli is a command line client for https://pushover.net to send pushover notifications. Moreover it is possible with this client to pipe streams directly to your cellphone like tail -f /var/log/my.log | pushover-cli -

Notifications You must be signed in to change notification settings

markus-perl/pushover-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 

Repository files navigation

pushover-cli

pushover-cli is a Python-based command-line client for https://pushover.net to send pushover notifications. This can be used for a variety of purposes, including:

  • Sending control messages to an old phone running Youtube to start/pause/stop/etc. the playing video remotely.
  • Piping streams to your cellphone (e.g. tail -f /var/log/my.log | pushover-cli -)
  • It's essentially an MQTT channel, so anything that can read a pushover message can act on it.
  • Tie pushover notifications into your long-running scripts (build, cleanup, upgrade, etc.) to get notices of different system events.

Requirements

Download and installation

Simply execute the following command to install the latest version of this script to your system:

sudo curl -o /usr/bin/pushover-cli https://raw.githubusercontent.com/markus-perl/pushover-cli/master/pushover-cli 
sudo chmod 555 /usr/bin/pushover-cli

Commandline options

Usage:   pushover-cli [options] <message> <title>
Stdin:   pushover-cli [options] - <title>
Example: pushover-cli -u ubLBe5u3zNXF9gBtX2zKkezSuPgu3v -t aK5BW3sjAqPsedH44VyQSbaQecoRen "Hello World"

    -u --user     <user id>             Pushover User-ID
    -t --token    <api token>           Pushover API-Token
    -d --device   <device name>         Device Name (if omitted, will broadcast to all devices)
    -p --priority <highest, high, normal, low, lowest>   Default: normal
    -l --url      <url>                 Link the message to this URL
    -s --sound    <notification sound>  Default: pushover - see https://pushover.net/api#sounds
    -c --config   <path to file>        Default: /etc/pushover.conf
    -v --verbose                        Be verbose
    -q --quiet                          Be quiet

Proxy Utilization

Incorporating the PR from acaranta that enabled proxy support, if the HTTP_ENV environment variable is pointed at a proxy server URL, pushover-cli will treat that as the proxy gateway and route the message to Pushover through it.

Config file

Every command line option can also be set by creating the config file ~/.pushover-cli.conf or /etc/pushover-cli.conf

Example file:

user=<Pushover User ID>
token=<Pushover Application API Token>
priority=normal
verbose=0
quiet=0

After creating this file it is no more necessary to specify these options in the command line which makes it more easier to send a message:

$ pushover-cli "My Message" "My Title"

or

$ pushover-cli -d 'my_phone' 'My Message' 'My Title'

or

$ pushover-cli -s 'none' 'My Message' 'My Title'

for silent notification or use other tones https://pushover.net/api#sounds

About

pushover-cli is a command line client for https://pushover.net to send pushover notifications. Moreover it is possible with this client to pipe streams directly to your cellphone like tail -f /var/log/my.log | pushover-cli -

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages