Palaver ZNC Module
Palaver ZNC module provides push notifications to Palaver while Palaver is disconnected from IRC.
When will I get notifications?
You will receive a push notification when any of the following rules are met:
- You get a private message directly to you.
- Any message which includes your current nickname.
- A message contains a mention keyword from the mention keywords in
Settings > Mentions
Notifications will ONLY be sent if all your clients are disconnected, or marked as away. You can use the clientaway module to mark a connected client as away.
This is so while you are on IRC on another device you wont receive many notifications on your phone at the same time.
Download the module
Via wget (recommended)
$ wget https://github.com/cocodelabs/znc-palaver/archive/master.tar.gz $ tar -xzf master.tar.gz $ cd znc-palaver-master
$ git clone https://github.com/Palaver/znc-palaver $ cd znc-palaver
Installation the module
Copy the compile ZNC module to your ZNC settings:
$ mkdir -p ~/.znc/modules $ cp palaver.so ~/.znc/modules
Now load the ZNC module:
/msg *status loadmod palaver
When upgrading the module to a newer version be sure to run
/msg *status unloadmod palaver before you copy the updated module into
place. Without doing this, you may experience an issue where you will be
unable to load the update version correctly without restarting ZNC.
If you are having any problems with the module you can follow the following steps to debug your setup.
- Ensure you are running the latest version of the ZNC Palaver module and ZNC 1.6 or newer.
- Check if your device has successfully registered with ZNC. You can run
/msg *palaver infoand it will let you know if your device is registered.
/msg *palaver testto send a test notification to your registered devices.
My device is registered, but I don't receive any push notifications
There may be a few reasons for this problem, you can run ZNC in debug mode
znc --debug) while you send
/msg *palaver test to find out more.
ZNC will then output why the notification failed to send.
SSL Handshake failure
This is most likely due to using older versions of OpenSSL. Upgrading to the latest version of OpenSSL and recompiling ZNC against the modern version of OpenSSL should solve your problem.
"Connect Failed. ERRNO " or "Network is unreachable"
This error indicates that ZNC was unable to send the push notification due to the network being unreachable. This may be that caused by your operating system or ZNC being configured for IPv6 when your service provider does not support it.
To solve this problem you can force IPv4 connections in ZNC using:
/msg *status setbindhost 0.0.0.0
Caught regex error
This error indicates a problem with the C++ regex implementation in your C++ compiler. Older versions of GCC have buggy implementations of regex and are incompatible with the module. GCC 4.9 or newer, and Clang are known to work. Please upgrade to a modern version.