Plugin:XMPP

Version: STATUSNET_VERSION

by: Craig Andrews, Evan Prodromou

source: http://gitorious.org/statusnet/mainline/trees/master/plugins/Xmpp/

description: The XMPP plugin allows users to send and receive notices over the XMPP/Jabber network.

debugging & testing
"Now that identi.ca is stabler, and freelish.us reborn, XMPP is coming up my list." @evan, 2012-02-07

"I'm not looking forward to debugging and testing this code (brand new for 1.0), so if others do it it would help a lot." @evan


 * Install StatusNet
 * enable XMPP interface
 * try posting to it
 * and receiving messages.

Issues

 * XMPP daemon high CPU usage
 * see @sazius' wiki
 * see this patch
 * read this conversation

The XMPP Bot
StatusNet comes with a XMPP bot written in php. If that bot is running at your server, you can post and receive dents within your XMPP/Jabber client&#8317;¹&#8318;. The bot will then act as a normal contact. To publish notices just send them to the bot, in exchange you get all the dents from your webinterface all time-line (and eventually also @replies from peoples you're not subscribed to) delivered into your client.

At identi.ca the bot can be reached at update(at)identi.ca. Other servers may or may not offer the bot.

After you registered the XMPP bot as a contact, you have to configure its behaviour. The settings for XMPP are located in the upper menu Connect and then the IM tab.

Bot Commands
The XMPP bot understands some commands to do things via XMPP that you also can do in the webinterface. You can tell the bot to show a basic help just by sending the word help to it. No preceding / like in IRC.

At the moment the XMPP bot understands the following commands: on ................... turn on notifications off .................. turn off notifications help ................. show this help follow .... subscribe to user leave ..... unsubscribe from user d. direct message to user get ....... get last notice from user whois ..... get profile info on user fav ....... add user's last notice as a 'fave' fav # ..... add notice with the given id as a 'fave' stats ................ get your stats stop ................. same as 'off' quit ................. same as 'off' sub ....... same as 'follow' unsub ..... same as 'leave' last ...... same as 'get' groups ............... lists the groups you have joined subscriptions ........ list the people you follow subscribers .......... list the people that follow you reply # ... reply to notice with a given id reply ..... reply to the last notice from user join ......... join group drop ......... leave group nudge ..... remind a user to update.

IdentiSpy
IdentiSpy was a real-time tracker by @dustin and @kshep. You can use it to track topics from identi.ca and the TWiT Army. You can also use it to post to these two and twitter.

To use IdentiSpy just add laconica(at)west.spy.net to your contact list and tell it the topics to track with the command track topic Then wait some minutes and IdentiSpy will send you all notices in which the topic was mentioned.

If you don't want to get the notices from one particular user, you can add an add_stop from:user to your track list. You will not receive any more notices from that user in the tracker. Also you can tell IdentiSpy to not send you notices covering a specific topic by add_stop badtopic

For further information please ask "help" in the chat window with IdentiSpy and have a look at the homepage at microblog.org/wiki/IdentiSpy.

IdentiChat
If you rather like to have a "multi user chat" (MUC) interface for your identi.ca usage, you can use the IdentiChat service by @zeen. For each user exists a MUC that you can access at your-identica-id@identichat.prosody.im. Beside you, all the accounts you are subscribed to are participants in the MUC, but once you can post there, the service posts every notice of the other participants.

To register at IdentiChat you have to send !register identica-username identica-password as message in the MUC, the bot will recognize this as your identi.ca login data and save them in association to your Jabber ID.

For more information please visit the service homepage at identichat.prosody.im.

Setting up your own XMPP
If you have your own installation of StatusNet, you can find info on how to set up a XMPP bot at XMPP Setup.