Plugin:XMPP

This article is a stub. You can help us by expanding it.

---

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. [1]

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⁽¹⁾. 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 <nickname> .... subscribe to user
leave <nickname> ..... unsubscribe from user
d <nickname> <text>  . direct message to user
get <nickname> ....... get last notice from user
whois <nickname> ..... get profile info on user
fav <nickname> ....... add user's last notice as a 'fave'
fav #<notice_id> ..... add notice with the given id as a 'fave'
stats ................ get your stats
stop ................. same as 'off'
quit ................. same as 'off'
sub <nickname> ....... same as 'follow'
unsub <nickname> ..... same as 'leave'
last <nickname> ...... same as 'get'
groups ............... lists the groups you have joined
subscriptions ........ list the people you follow
subscribers .......... list the people that follow you
reply #<notice_id> ... reply to notice with a given id
reply <nickname> ..... reply to the last notice from user
join <group> ......... join group
drop <group> ......... leave group
nudge <nickname> ..... 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.

References

• (1) Google Talk is an XMPP service.