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.4 (which means no support for /occupants pane in rooms), 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

Use

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

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

/account set hipchat password [your password]

If you don't wanna hate your life

If your nickname (full name) has spaces, and I bet it does, use quotes. Example:

/account set hipchat nick "Jon Doe"

Quotes also works when messaging a person's full name, as noted.