Configuring profanity.im for Hipchat on OS X

steps.md

Configuring profanity.im for Hipchat on OS X

Installation

Easy

brew install profanity

• The latest build available today via homebrew is 0.4.7, and it does not support desktop notifications.

If the tap works for you, try to install the latest dev version via (I had some trouble, idk):

brew tap robsalasco/homebrew-profanity
brew install profanity --HEAD --with-terminal-notifier

Pro

• libstrophe available via Homebrew is not linked against expat, so we need to build that first
• Throwing in desktop notifications since you know you want them

Install dependencies:

brew install expat terminal-notifier libtool glib

Clone and build libstrophe:

    git clone https://github.com/strophe/libstrophe.git && cd libstrophe
    ./bootstrap.sh
    ./configure
    make
    make install
    cd ..

Clone and build profanity:

    git clone https://github.com/boothj5/profanity.git && cd profanity
    ./bootstrap.sh
    ./configure
    make
    make install
    cd ..

Running

profanity

Configuring

1. Get your XMPP info from Account Settings: http://hipchat.com/account/xmpp
2. Set up your account in profanity (so you don't need to do this more than once):

    /account add hipchat
    /account set hipchat jid [account id]@chat.hipchat.com
    /account set hipchat nick [Full Name]
    /account set hipchat port 5222
    /account set hipchat muc conf.hipchat.com

If you are hosting the Hipchat server yourself make sure to also add the host information to the server:

    /account add hipchat host [your.hipchat.server]

Use

From within profanity, run /connect hipchat and you're off!

To store the password:

    /account set hipchat password [your password]

• As far as I can tell, Hipchat does not respect bookmark and autojoin settings, so don't bother with /bookmark delete or /bookmark update. All rooms are always bookmarked.

• List rooms: /rooms

• Join a room: /join [room name] - Names should autocomplete

• List open windows: /wins - /win 1 is the console

• Private message a user: /msg "[Full Name]" - Names should autocomplete

• Desktop notification settings: /notify

• Set the reconnect timer to something more reasonable with /reconnect 3 (for a 3-second timer). Default is 30 seconds.