Buy Now
General Info

Push Notification Bouncers

Colloquy Bouncer

Colloquy for Mac now includes a bouncer that makes it easy to stay connected using the same connections you already have on your Mac, with push notifications! Just enable the bouncer and create a account and password in Colloquy’s Bouncer preferences. More information on how to setup the bouncer can be found on our Wiki.

ZNC Bouncer

A beta version of the ZNC module that supports Colloquy’s push protocol is available for Mac OS X, Linux and Windows.

Push API

Colloquy will send a series of commands to the connection when push is enabled. These commands can be intercepted by any bouncer and use our API to send push notifications. PUSH add-device [device-token] :[device-name]
PUSH service colloquy.mobi 7906
PUSH connection [connection-id] :[connection-name]
PUSH highlight-word :[highlight-word]
PUSH highlight-sound :[sound-name]
PUSH message-sound :[sound-name]
PUSH end-device
When push is disabled for a connection, Colloquy will send a single command to remove the device. This is the bouncer’s cue to stop sending push notifications. PUSH remove-device [device-token] The server protocol is JSON over an SSL connection to colloquy.mobi over port 7906. An example push looks somthing like this: {
  "device-token": "abcdef123456789…",
  "message": "kiji: Hello!",
  "sender": "jane",
  "room": "#colloquy-mobile",
  "server": "irc.freenode.net",
  "badge": 1,
  "sound": "Beep 1.aiff"
}
The server will take care of formatting the message (emoji substitution, etc.) and making sure it is truncated to fit Apple's 256 character limit.

You can use this Perl module and sample script as a starting point of your push bouncer integration.