Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Tag: 0.0.7
Fetching contributors…

Cannot retrieve contributors at this time

49 lines (32 sloc) 1.374 kB


Switchboard is both a toolkit for assembling XMPP clients as well as a set of command-line tools for interacting with XMPP servers.

Getting Started

Install it:

$ sudo gem install mojodna-switchboard -s

Install optional dependencies for additional functionality:

$ sudo gem install oauth # (for OAuth PubSub support)
$ sudo gem install fire-hydrant # (for User Location support)
$ sudo gem install rb-appscript # (for User Tune support)

Configure it:

$ switchboard config jid
$ switchboard config password pa55word

Settings will be stored in $HOME/.switchboardrc

Run it:

$ switchboard <command> <args>
$ switchboard roster list
$ switchboard roster add
$ ...

Subscribe to a node using OAuth, overriding default settings:

$ switchboard --jid --password pa55word \
    pubsub --oauth \
    --oauth-consumer-key <consumer key> \
    --oauth-consumer-secret <consumer secret> \
    --oauth-token <token> \
    --oauth-token-secret <token secret> \
    --server \
    --node "/api/0.1/user/<token>" \

Publish iTunes' current track using UserTune (XEP-0118):

$ switchboard --resource switchtunes pep tune

You can do this using a JID that is already online.

Jump to Line
Something went wrong with that request. Please try again.