wiki:PushNotifications

Version 5 (modified by zach, 9 years ago) (diff)

--

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.
  1. 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. curl -LO http://shizno.com/colloquy.cpp works.
  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".

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 does not yet clear the badge number for Colloquy.

Troubleshooting Tips

  • 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.