jabber.el


a minimal jabber client for emacs


SourceForge.net Logo

see also the JabberEl page of EmacsWiki, the mailing list and the chat room (it's jabber.el@conference.jabber.se, if your web browser is not configured for XMPP URIs).

if you use GNU Arch, you can use the Arch mirror of the CVS repository. these commands get it for you:

tla register-archive http://www.dtek.chalmers.se/~henoch/archive-2005
tla get mange@freemail.hu--2005/emacs-jabber--cvs-head--0 emacs-jabber

it's manually maintained, so bug Magnus (JID: legoscia@jabber.cd.chalmers.se) if it doesn't seem up to date.

version 0.7.1 - 31-Jan-2007

Read the manual.

version 0.7 - 27-Dec-2005

Read the manual.

version 0.6.1 - 27-Dec-2004

Read the manual, in which there is now a section on protocol support.

version 0.6 - 17-Oct-2004

Read the manual.

version 0.5.1 - 08-May-2004

version 0.5 - 03-April-2004

version 0.4.1 - 16-February-2004

version 0.4 - 05-February-2004

version 0.3 - 21-April-2002


version 0.2 - 05-April-2002



features currently missing (TODO)



installation

get the module emacs-jabber from Sourceforge CVS. additionally, if you don't have Gnus 5.10 (M-x gnus-version will tell), you will need hex-util.el and sha1-el.el from Gnus CVS. copy these to a directory in your emacs load path.

in your .emacs file add the call (require 'jabber). you can also use auto-load.

set your account details with M-x jabber-customize. then, type M-x jabber-connect to connect, and M-x jabber-send-presence to send initial presence.

please note that the current version is dependant on gnu-emacs-21 - it depends on xml.el (which you can download separately) and on some newer functions.

howto

as jabber.el is still very young, you'll have to be rather emacs-savvy to use it (or at least have the willingness to learn a little).

to connect to the server, call (jabber-connect).
call it from the pull-down menu or call interactively : [M-x jabber-connect RET] and enter the parameters from the minibuffer.

after a successful connection, a new buffer should appear, named *-jabber-*. this buffer is your roster view. click any user with the mouse to start a 1-on-1 chat.

alternatively, you can also call (jabber-chat-with jid).
for example : (jabber-chat-with "object@magaf.org")
or [M-x jabber-chat-with RET]. in that case you will be asked for a jid. use the TAB key to complete a partial jid from the roster. (nice, eh?)

to send a message, call (jabber-send-message to body subject type)
for example : (jabber-send-message "object@magaf.org" "hi there" "" "") will appear as an instant message.
(jabber-send-message "object@magaf.org" "tom, you are the best" "the truth, nothing but the truth" "normal") too.
(jabber-send-message "object@magaf.org" "hya" "" "chat") will appear as a 1-on-1 chat
of course, this too can be called interactively : [M-x jabber-send-message RET] (with jid completion, like anywhere else).

to change your status, call (jabber-send-presence show status).
for example : (jabber-send-presence "" "Online") to appear online, or (jabber-send-presence "dnd" "copulating") to appear lucky.
needless to say, this can be called from the minibuffer too. do [M-x jabber-send-presence RET] and enjoy TAB completion from "", "away", "xa", "dnd" or "chat" for the first parameter (show).

when a new chat message arrives, it is sent to the chat buffer ("*jabber-chat-:-user*"). if such a buffer does not exist it is created. in this buffer, all straight keystrokes are being captured for starting the reply command. to send a line, simply start typing...

all messages are converted to 1-on-1 chats (simply because i find that more convinient).

contact

jabber.el is written by Tom Berger (Jabber: object@jabber.org.uk) and Magnus Henoch (Jabber: legoscia@jabber.cd.chalmers.se). feel free to contact us. you can also report bugs at the Sourceforge project page.