4 <title>jabber.el
</title>
8 <h2>a minimal jabber client for emacs
</h2><br>
9 <!-- here are some <a href="http://intellectronica.net/emacs-jabber/screenshots/">screenshots</a>.<br>
10 <b>newsflash : jabber.el is no longer here. go to <a href="http://www.sf.net/projects/emacs-jabber">sourceforge</a> for the latest version</b>
12 <a href=
"http://sourceforge.net">
13 <img border=
"0" src=
"http://sourceforge.net/sflogo.php?group_id=88346&type=2" width=
"125" height=
"37" alt=
"SourceForge.net Logo" style=
"position: absolute; top: 0em; right: 0em;"></a>
15 <p>see also
<a href=
"http://www.emacswiki.org/cgi-bin/wiki/JabberEl">the
16 JabberEl page of EmacsWiki
</a>,
<a href=
"http://lists.sourceforge.net/lists/listinfo/emacs-jabber-general">
17 the mailing list
</a> and
<a href=
"xmpp:jabber.el@conference.jabber.se?join">the chat room
</a> (it's
<code>jabber.el@conference.jabber.se
</code>, if your web browser is not configured for XMPP URIs).
</p>
19 <p>if you use
<a href=
"http://wiki.gnuarch.org">GNU Arch
</a>, you can use the
20 Arch mirror of the CVS repository. these commands get it for you:
</p>
22 <pre>tla register-archive http://www.dtek.chalmers.se/~henoch/archive-
2005
23 tla get mange@freemail.hu--
2005/emacs-jabber--cvs-head--
0 emacs-jabber
</pre>
25 <p>it's manually maintained, so bug Magnus (JID:
<a href=
"xmpp:legoscia@jabber.cd.chalmers.se">legoscia@jabber.cd.chalmers.se
</a>) if it
26 doesn't seem up to date.
</p>
28 <h3>version
0.7.1 -
<a href=
"http://sourceforge.net/project/showfiles.php?group_id=88346&package_id=92339&release_id=482983">31-Jan-
2007</a></h3>
32 <li>SRV records (requires No Gnus)
</li>
33 <li>Message composition buffer
</li>
34 <li>XMPP URIs are handled (see
<a href=
"manual-0.7.1/XMPP-URIs.html">manual
</a> for setup)
</li>
39 <li>Don't display alerts for your own messages
</li>
40 <li>Presence changes are sent to MUC rooms too
</li>
41 <li>Check room features before joining
</li>
46 <li>File transfer
</li>
48 <li>Sound files per contact for alerts
</li>
50 <li>New function: jabber-send-directed-presence
</li>
52 <li>Entity time supported (XEP-
0090)
</li>
54 <li>Last activity supported (XEP-
0012)
</li>
57 <p>Read the
<a href=
"manual-0.7.1/">manual
</a>.
</p>
60 <h3>version
0.7 -
<a href=
"http://sourceforge.net/project/showfiles.php?group_id=88346&package_id=92339&release_id=381160">27-Dec-
2005</a></h3>
63 <li>SSL connections possible
</li>
64 <li>Chat buffers rewritten
</li>
66 <li>Global key bindings under C-x C-j
</li>
67 <li>Vcard viewer and editor
</li>
68 <li>Roster export
</li>
69 <li>Message events (JEP-
0022)
</li>
70 <li>Easy way to define external notifiers
</li>
71 <li>Activity mode improved
</li>
72 <li>Roster display optimized
</li>
73 <li>Optionally use per-contact history files
</li>
74 <li>Jabber menu in menubar not enabled by default
</li>
75 <li>Flyspell in chat buffers
</li>
76 <li>Different time formats for instant and delayed messages
</li>
77 <li>Chat buffers in inactive windows are scrolled
</li>
78 <li>Roster is sorted by name also
</li>
79 <li>Countless bugfixes
</li>
82 <p>Read the
<a href=
"http://emacs-jabber.sourceforge.net/manual-0.7/">manual
</a>.
</p>
84 <h3>version
0.6.1 -
<a href=
"http://sourceforge.net/project/showfiles.php?group_id=88346&package_id=92339&release_id=292750">27-Dec-
2004</a></h3>
87 <li>Now works with ejabberd
</li>
88 <li>Message history (Mathias Dahl)
</li>
90 <li>Activity tracking on the mode line (Carl Henrik Lunde)
</li>
91 <li>Receive an alert when a specific person goes online (Mathias Dahl)
</li>
92 <li>Support for /me in chats (Nolan Eakins)
</li>
93 <li>Message alerts for current buffer can be disabled
</li>
94 <li>Basic moderation support in MUC
</li>
95 <li>MUC alerts are separated from ordinary message alerts
</li>
99 <a href=
"http://emacs-jabber.sourceforge.net/manual-0.6.1/">manual
</a>,
100 in which there is now a section on
101 <a href=
"http://emacs-jabber.sourceforge.net/manual-0.6.1/Protocol-support.html">protocol support
</a>.
</p>
103 <h3>version
0.6 -
<a href=
"http://sourceforge.net/project/showfiles.php?group_id=88346&package_id=92339&release_id=275815">17-Oct-
2004</a></h3>
106 <li>Chat buffers no longer use the minibuffer, making it easier to use
107 ordinary editor commands and to pause writing halfway
</li>
108 <li>The roster display and the chat buffer prompts are now customizable
</li>
109 <li>The online status of the contact is displayed in the chat buffer
111 <li>The connect function automatically sends presence after connecting
</li>
112 <li>The names of the roster buffer and chat buffers are customizable
</li>
113 <li>RET and C-k do what you would expect in the roster buffer
</li>
116 <p>Read the
<a href=
"http://emacs-jabber.sourceforge.net/manual-0.6/">manual
</a>.
</p>
118 <h3>version
0.5.1 -
<a href=
"http://sourceforge.net/project/showfiles.php?group_id=88346&package_id=92339&release_id=236857">08-May-
2004</a></h3>
121 <li>Nicknames are accepted whenever a JID is asked for.
</li>
122 <li>Roster entry spacing is customizable (default is none)
</li>
123 <li>Bug fix regarding mixed-case JIDs
</li>
124 <li>Experimental code for receiving files - see the README
</li>
125 <li>Read the
<a href=
"http://emacs-jabber.sourceforge.net/manual-0.5.1/">manual
</a></li>
128 <h3>version
0.5 -
<a href=
"http://sourceforge.net/project/showfiles.php?group_id=88346&package_id=92339&release_id=228471">03-April-
2004</a></h3>
131 <li>Modular design; plugins easier to write
</li>
132 <li>Support for Ad-Hoc Commands and setting presence remotely
</li>
133 <li><a href=
"manual-0.5/">Browse documentation here
</a></li>
136 <h3>version
0.4.1 -
<a href=
"http://sourceforge.net/project/showfiles.php?group_id=88346&package_id=92339&release_id=217577">16-February-
2004</a></h3>
138 <li> XEmacs support - basically works, needs testing and care.
</li>
139 <li> "Set status" menu fixed
</li>
142 <h3>version
0.4 -
05-February-
2004</h3>
144 <li> SHA-
1 password hashing
</li>
145 <li> customisation hooks
</li>
146 <li> browsing improved
</li>
147 <li> added service discovery
</li>
148 <li> added in-band registration
</li>
149 <li> added searching
</li>
150 <li> <a href=
"/emacs-jabber/jabber.html">new manual
</a></li>
152 <h3>version
0.3 -
21-April-
2002</h3>
154 <li> improved groupchat support (thanks to nimrod for tip)
</li>
155 <li> improved roster (buddy-list) display
</li>
156 <li> infoquery rewritten - great improvement
</li>
157 <li> improved minimal browsing support !
</li>
158 <li> added customizable faces
</li>
159 <li> added more customizable variables
</li>
160 <li> more (helpful) comments in code
</li>
161 <li> added explicit licensing (GPL, like emacs itself)
</li>
163 <h3>version
0.2 -
05-April-
2002</h3>
165 <li> added groupchat support !
</li>
166 <li> added minimal browsing support !
</li>
167 <li> fixed bug in chat mode
</li>
168 <li> abolished message mode (i only use chat mode anyway)
</li>
169 <li> fixed some problems with incoming xml
</li>
170 <li> added a pull-down menu
</li>
171 <li> added customizable variables
</li>
174 <h3>features currently missing (TODO)
</h3>
176 <li> global keymaps
</li>
177 <li> logging (history)
</li>
178 <li> overall exception handling
</li>
179 <li> sanity checks (for incoming xml, and for myself :)
</li>
180 <li> clickable URLs in messages
</li>
181 <li> support for versions other than gnu-emacs-
21 (older emacs, xemacs, jemacs)
</li>
182 <li> and more...
</li>
185 <h3>installation
</h3>
186 <p>get the module
<kbd>emacs-jabber
</kbd> from
<a href=
"http://sourceforge.net/cvs/?group_id=88346">Sourceforge CVS
</a>.
187 additionally, if you don't have Gnus
5.10 (
<kbd>M-x gnus-version
</kbd> will tell), you will need
<kbd>hex-util.el
</kbd>
188 and
<kbd>sha1-el.el
</kbd> from
<a href=
"http://quimby.gnus.org/cgi-bin/cvsweb.cgi/gnus/lisp/">Gnus CVS
</a>.
189 copy these to a directory in your emacs load path.
</p>
190 <p>in your .emacs file add the call
<kbd>(require 'jabber)
</kbd>. you can also use auto-load.
</p>
191 <p>set your account details with
<kbd>M-x jabber-customize
</kbd>. then, type
<kbd>M-x jabber-connect
</kbd> to connect,
192 and
<kbd>M-x jabber-send-presence
</kbd> to send initial presence.
</p>
193 <p>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.
</p>
195 <p>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).
<br></p>
196 <p>to connect to the server, call
<i>(
<b>jabber-connect
</b>)
</i>.
<br>
197 call it from the pull-down menu or call interactively : [M-x jabber-connect RET] and enter the parameters from the minibuffer.
</p>
198 <p>after a successful connection, a new buffer should appear, named
<b>*-jabber-*
</b>. this buffer is your roster view. click any user with the mouse to start a
1-on-
1 chat.
</p>
199 <p>alternatively, you can also call
<i>(
<b>jabber-chat-with
</b> jid)
</i>.
<br>
200 for example : (jabber-chat-with
"object@magaf.org")
<br>
201 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?)
</p>
202 <p>to send a message, call
<i>(
<b>jabber-send-message
</b> to body subject type)
</i><br>
203 for example : (jabber-send-message
"object@magaf.org" "hi there" "" "") will appear as an instant message.
<br>
204 (jabber-send-message
"object@magaf.org" "tom, you are the best" "the truth, nothing but the truth" "normal") too.
<br>
205 (jabber-send-message
"object@magaf.org" "hya" "" "chat") will appear as a
1-on-
1 chat
<br>
206 of course, this too can be called interactively : [M-x jabber-send-message RET] (with jid completion, like anywhere else).
</p>
207 <p>to change your status, call
<i>(
<b>jabber-send-presence
</b> show status)
</i>.
<br>
208 for example : (jabber-send-presence
"" "Online") to appear online, or (jabber-send-presence
"dnd" "copulating") to appear lucky.
<br>
209 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).
</p>
210 <p>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...
</p>
211 <p>all messages are converted to
1-on-
1 chats (simply because i find that more convinient).
</p>
213 <p>jabber.el is written by
<a href=
"http://intellectronica.net/object/">Tom Berger
</a> (Jabber: object@jabber.org.uk) and
214 Magnus Henoch (Jabber: legoscia@jabber.cd.chalmers.se). feel free to contact us. you can also report bugs at the
215 <a href=
"http://sourceforge.net/projects/emacs-jabber/">Sourceforge project page
</a>.
</p>