public
Description: A toolkit for assembling XMPP clients and interacting with XMPP servers.
Homepage:
Clone URL: git://github.com/mojodna/switchboard.git
name age message
file .gitignore Wed Nov 12 14:20:44 -0800 2008 minimal gemspec [mojodna]
file History.txt Wed Jul 08 16:14:15 -0700 2009 0.1.0 release [mojodna]
file README.markdown Tue Jul 21 22:26:34 -0700 2009 'official' release, links to some docs [mojodna]
file Rakefile Tue Jul 21 22:25:30 -0700 2009 fix dependency syntax [mojodna]
directory bin/ Wed Nov 04 19:49:15 -0800 2009 changes for 0.1.1 [mojodna]
directory examples/ Wed Feb 18 11:09:41 -0800 2009 no longer in sync with the API [mojodna]
directory lib/ Thu Nov 05 10:18:27 -0800 2009 clarify rules for connecting anonymously [mojodna]
file switchboard.gemspec Wed Nov 04 19:49:15 -0800 2009 changes for 0.1.1 [mojodna]
README.markdown

Switchboard

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

Docs

Mailing List

Switchboard Google Group

Getting Started

Install it:

$ sudo gem install switchboard

Install optional dependencies for additional functionality.

OAuth PubSub support:

$ sudo gem install oauth

User Location (XEP-0080) support via Fire Eagle:

$ sudo gem install mojodna-fire-hydrant -s http://gems.github.com

Note: you will need to set up a PubSub subscription to your location via Fire Eagle for this to work.

User Tune (XEP-0118) support via iTunes (on Mac OS X):

$ sudo gem install rb-appscript

Configure it:

$ switchboard config jid jid@example.com
$ switchboard config password pa55word

Settings will be stored in $HOME/.switchboardrc

Run it:

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

Subscribe to a node using OAuth, overriding default settings:

$ switchboard --jid subscriber@example.com --password pa55word \
    pubsub --oauth \
    --oauth-consumer-key <consumer key> \
    --oauth-consumer-secret <consumer secret> \
    --oauth-token <token> \
    --oauth-token-secret <token secret> \
    --server fireeagle.com \
    --node "/api/0.1/user/<token>" \
    subscribe

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

$ switchboard --resource switchtunes pep tune

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