wiki:PushNotifications

Table of Contents

  1. Colloquy Bouncer for Mac OS X
  2. ZNC for Mac OS X and Linux
  3. ZNC for Windows

Colloquy Bouncer for Mac OS X

  1. Download the latest version of Colloquy (2.3).
  2. Open Preferences and go to the Bouncer tab.
  3. Check "Enable bouncer for IRC connections"
  4. Create an Account Name and set an Account Password. This is used to log into Colloquy for Mac OS X from Colloquy on your iPhone or iPod touch.
  5. Set up a Listening Port. This can be any number from 1 to 65,536. The default Listening Port is 6667.
  6. Check to see if your Listening Port is open here. Colloquy will try and open this up automatically for you.
    • If the site reports "Success", then you are done setting up Colloquy for Mac OS X up.
    • If the site reports "Error", then Colloquy could not automatically forward your port. Please see this page for instructions on how to open up a Listening Ports on your router. Follow instructions for "mIRC Chat", but replace " 6660-6669" with the Listening Port that you chose.
  7. Find the IP address of your computer here, if necessary.

Mobile Colloquy

  1. Hit the + Button in the Connections tab and select "Colloquy Bouncer".
  2. Enter the IP Address of the computer that the Colloquy Bouncer is running on in the Address field.
  3. Enter the Listening Port you previously set up in the Port field.
  4. Enter the Account Name and Account Password in the Account and Password fields.
  5. Hit "Connect".

Result: If all went well, you should now see a list of all connections that Colloquy on your Mac has available, on your iPhone or iPod touch.

Troubleshooting Tips

  • Colloquy doesn't let you highlight yourself to send a Push Notification.
  • Make sure your port is open.
  • Make sure you're connecting to the right IP Address.
  • Make sure Colloquy is running.
  • Make sure you didn't typo your Account Name.
  • Make sure the passwords are the same.

ZNC for Mac OS X and Linux

  1. Install ZNC.
  2. Download the source for the Push plugin (latest, 1.1, 1.0).
    • one way to get the latest version:
      curl -LO http://github.com/wired/colloquypush/raw/master/znc/colloquy.cpp
      
  3. Type znc-buildmod colloquy.cpp
  4. Move colloquy.so to ZNC's modules folder. By default, this is ~/.znc/modules/.
  5. Load the Push module with ZNC, either through webadmin or by typing /msg *status loadmod colloquy.
  6. For help and options, type /msg *colloquy help or /msg *colloquy status in your IRC client.

Note: if you want to disable push when another client is connected to znc, pass the following argument to the colloquy module (make sure your module is up-to-date):

-attachedpush 0

or send a message to *colloquy after loading the module:

/msg *colloquy attachedpush 0

ZNC for Windows

  1. Download ZNC for windows
  2. Install ZNC.
  3. Download the Push plugin. http://code.google.com/p/znc-msvc/downloads/list
  4. Unzip and move colloquy.dll to ZNC's modules folder. By default, this is ~/znc/modules/.
  5. Load the Push module with ZNC, either through webadmin or by typing "/msg *status loadmod colloquy".

Mobile Colloquy

  1. Hit the + Button in the Connections tab and select "IRC Connection"
  2. Enter the server address as the Address.
  3. Select "Push Notifications" and then turn them On.
  4. Go to "Advanced".
  5. Enter the Server Port and toggle SSL status as necessary.
  6. Enter your ZNC account name as your Username.
  7. Enter your ZNC account password as the Password. (Note: not Nick Pass).
  8. Go back and hit "Connect".

Result: If all went well, you should get a message from *colloquy saying that push is now loaded on ZNC for your device. You can also type "/msg *colloquy list" to see all of the devices that receive push notifications from your ZNC account.

Note: The plugin for ZNC is still a work in progress and may not update the badge number for Colloquy properly.

Troubleshooting Tips

  • Make sure you are using a moderately recent version of ZNC. The push plugin won't compile on builds of ZNC prior to 0.064. The push plugin is known to work on build of ZNC from 0.072 and on.
  • Make sure you're connecting to the right IP Address.
  • Make sure you didn't typo your Account Name.
  • Make sure the password is right.
  • If *status replies *status: Unable to find modinfo [colloquy], then make sure that colloquy.so is in the right location.
  • You may have to open up port 7906 outgoing (TCP) is open on your server for push notifications to work properly.
Last modified 4 weeks ago Last modified on Nov 20, 2014 9:47:15 AM