Unoffical Flowdock XMPP (Jabber) Gateway
Clojure
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src/flowdock_xmpp
.gitignore
.npmignore
LICENSE
README.md
package.json
project.clj

README.md

flowdock-xmpp

Unofficial Flowdock XMPP (Jabber) Gateway

Usage

You can connect to flowdock-xmpp using your personal API token in your JID (you can pick any value for your password).

If you are not eager to run your own instance of flowdock-xmpp you can connect to a public one by using <API_TOKEN>@flowdock.ozansener.com.

Joining rooms

If your client supports XMPP bookmarks you can use them to join flows;

  • In Psi right click the server name and select the desired bookmark.

Otherwise, you have to enter room info manually;

  • In Adium choose File -> Join Group Chat and enter room info as follows:
    • Chat Room Name: flow-name#room-name. For example, if your flow url is https://www.flowdock.com/app/foo-bar/main you should enter it as foo-bar#main
    • Server: This should be the hostname of the flowdock-xmpp instance. For example, flowdock.ozansener.com.

Installation

Prerequisites

First you might want to install libicu-dev package for your operating system. See the installation guide at http://node-xmpp.github.io/doc/nodestringprep.html for instructions. If you skip this step a slower JavaScript fallback is used instead.

Getting flowdock-xmpp

You can install flowdock-xmpp using npm install -g flowdock-xmpp.

Building it manually

After you install leiningen you can build and run flowdock-xmpp using

lein cljsbuild once
node bin/flowdock-xmpp.js

Possible environment configuration

  • FLOWDOCK_XMPP_DOMAIN: the domain you want to use for XMPP JIDs (defaults to system hostname).

  • FLOWDOCK_XMPP_KEY: path to a key file to be used for TLS connections (optional).

  • FLOWDOCK_XMPP_CERT: path to a cert file to be used for TLS connections (optional).

Disclaimer

This project is not affiliated with Flowdock. Use it at your own risk.