weechat-pushover

Weechat plugin to send notifications about query messages and channel hilights to your iPhone or Android via pushover.net.

Installation and Configuration

In order to use the plugin you need to take the following steps:

Register an account at http://pushover.net
Create a new application at https://pushover.net/apps/build
Note the "token" for your new application (referenced as TOKEN later on)
From the Dashboard at https://pushover.net note your "User key" (referenced as USERKEY later on)
Install the pushover app on your iPhone/Android and login
put "pushover.py" to ~/.weechat/python
start the plugin with "/python load pushover.py"
Set user key and token by doing
/set plugins.var.python.pushover.user USERKEY
/set plugins.var.python.pushover.token TOKEN

Optional:

Set a custom pushover sound: /set plugins.var.python.pushover.sound SOUND
Enable/Disable notifications by setting the following to "on" or "off": /set plugins.var.python.pushover.enabled OPTION
Enable/Disable highlights/private messages by setting the following to "on" or "off": /set plugins.var.python.pushover.show_highlight OPTION /set plugins.var.python.pushover.show_priv_msg OPTION
Filter out messages in particular channels/nicks: /set plugins.var.python.pushover.channel_excludes "somenick1,somechannel2" To filter out Bitlbee chatter, exclude "root"

Todo

Make it configurable to notify about current window or not.
Make it configurable to notify only while being in away mode.
Make it configurable to send more details (e.g. local timestamp).

Security

Due to the architecture used, this plugin does not use end-to-end-encryption. It mostly relies on SSL traffic encryption. Check official pushover FAQ for reference: https://pushover.net/faq#security-encryption

License

The script is derived from other scripts (see pushover.py for history). It is released under the GPL v2. See LICENSE file for details.

Author

Author: Caspar Clemens Mierau ccm@screenage.de