weechat-gotify/README.md
Adrian L Lange 945ff82bfa
2017-02-10 19:01:01 +01:00

47 lines
1.8 KiB
Markdown

# weechat-pushjet
A [WeeChat](https://weechat.org/) plugin that sends highlights and/or private message notifications through [Pushjet](https://pushjet.io/).
### Installation
In WeeChat install the script by typing the following:
```
/script install pushjet.py
```
If you're using the public push server, all you have to do is set the _`secret`_ option in the configuration.
### Options
The plugin allows you to set a few options through the normal WeeChat settings system.
You'll find all of them under _`plugins.var.python.pushjet`_, and all of them have helpful descriptions.
To set them use _`/set plugins.var.python.pushjet.foo bar`_ or through the [iset.pl](https://weechat.org/scripts/source/iset.pl.html) plugin.
- `host`
- host for the pushjet api (default: "https://api.pushjet.io")
- `secret`
- secret for the pushjet api (default: "")
- `level`
- severity level for the message, from 1 to 5 (low to high) (default: 4)
- `timeout`
- timeout for the message sending in seconds (>= 1) (default: 30)
- `separator`
- separator between nick and message in notifications (default: ": ")
- `notify_on_highlight`
- push notifications for highlights in buffers (on/off) (default: "on")
- `notify_on_privmsg`
- push notifications for private messages (on/off) (default: "on")
- `notify_when`
- when to push notifications (away/detached/always/never) (default: "always")
- `ignore_buffers`
- comma-separated list of buffers to ignore (default: "")
- `ignore_nicks`
- comma-separated list of users to not push notifications from (default: "")
### Issues
- The currently available version of Pushjet is sending the wrong error codes for errors.
This means that if your settings are invalid it's very hard to find out exactly what is wrong.
- Away status can't be checked when receiving private messages