znc-push/README.md

ZNC to Notifo

ZNC to Notifo is a module for ZNC that will send notifications to a Notifo account for any private message or channel highlight that matches a configurable set of conditions.

This project is still a Work In Progress, but should be functional enough and stable enough for everyday usage. Users are more than welcome to submit feature requests or patches for discussion or inclusion.

ZNC to Notifo was created by John Reese and designed to fill a personal need. It may not suit your use cases, but any and all feedback would be greatly appreciated.

Compiling

If you have make installed, you can compile the module with:

$ make

Otherwise, run the full command:

$ znc-build notifo.cpp

Installation

Copy the compiled module into your ZNC profile:

$ cp notifo.so ~/.znc/modules/

Now, load the module in ZNC:

/msg *status loadmod notifo

Then set your Notifo username and API secret:

/msg *notifo set username foo
/msg *notifo set secret ...

At this point, it should start sending notifications every time you get a private message or someone says your name in a channel. If this is everything you wanted, congratulations, you're done!

Commands

• help

  Links you to this fine document.

• set <option> <value>

  Allows you to modify configuration values.

• get [<option>]

  Allows you to see current configuration values.

• unset <option>

  Allows you to reset a configuration option back to the default value.

• status

  Check the status of current conditions.

• send <message>

  Manually trigger a notification with the given message. Useful for testing to validate credentials, etc.

Configuration

Conditions

• client_count_less_than = 0

  Notifications will only be sent if the number of connected IRC clients is less than this value. A value of 0 (zero) will disable this condition.

Notifications

• message_length = 100

  Maximum length of the notification message to be sent. The message will be nicely truncated and ellipsized at or before this length is reached. A value of 0 (zero) will disable this option.

• message_url = ""

  URI that will be sent with the notification to Notifo. This could be a web address or a local scheme to access a mobile application.

License

This project is licensed under the MIT license. See the LICENSE file for details.