#+TITLE: jabber.el #+OPTIONS: num:nil author:nil skip:nil #+BEGIN_HTML SourceForge.net Logo #+END_HTML jabber.el is a Jabber client for Emacs. [TABLE-OF-CONTENTS] # <> For the impatient: - Latest release: [[http://sourceforge.net/project/showfiles.php?group_id=88346&package_id=92339&release_id=482983][0.7.1]] (31-Jan-2007) - Latest pretest release: [[http://sourceforge.net/project/showfiles.php?group_id=88346&package_id=278300&release_id=662240][0.7.93]] (19-Feb-2009) - Full [[list-of-releases][list of releases]], including lists of features and changes External resources: - [[http://sourceforge.net/projects/emacs-jabber/][Sourceforge project page]], containing: - trackers for [[http://sourceforge.net/tracker/?atid=586350&group_id=88346&func=browse][bugs]], [[http://sourceforge.net/tracker/?atid=586353&group_id=88346&func=browse][feature requests]], [[http://sourceforge.net/tracker/?atid=586352&group_id=88346&func=browse][patches]] and [[http://sourceforge.net/tracker/?atid=586351&group_id=88346&func=browse][support requests]], open for anonymous posters - [[http://sourceforge.net/forum/?group_id=88346][forums]], open for anonymous posters - [[http://www.emacswiki.org/cgi-bin/wiki/JabberEl][the JabberEl page of EmacsWiki]] - Mailing lists (also available at [[http://gmane.net][Gmane]]): - [[http://lists.sourceforge.net/lists/listinfo/emacs-jabber-general][emacs-jabber-general]], for posts by humans (also [[http://dir.gmane.org/gmane.emacs.jabber.general][gmane.emacs.jabber.general]]) - [[http://lists.sourceforge.net/lists/listinfo/emacs-jabber-commit][emacs-jabber-commit]], read-only mailing list of CVS commits (also [[http://dir.gmane.org/gmane.emacs.jabber.scm][gmane.emacs.jabber.scm]]) - [[http://lists.sourceforge.net/lists/listinfo/emacs-jabber-bugs][emacs-jabber-bugs]], read-only mailing list of bug tracker activity (also [[http://dir.gmane.org/gmane.emacs.jabber.bugs][gmane.emacs.jabber.bugs]]) - the Jabber chat room #+HTML: jabber.el@conference.jabber.se - the [[file:manual-0.7.1/][manual for jabber.el 0.7.1]] (also included in the release files) * What is Jabber? Jabber is an open instant messaging (IM) system, also known as XMPP. It is described in [[http://www.xmpp.org/rfcs/][RFCs 3920-3923]] and a series of [[http://www.xmpp.org/extensions/][XEPs]] (XMPP Extension Proposals). That is, unlike legacy IM systems (such as ICQ or MSN Messenger), the protocol is published in the open, free for anyone to implement. Therefore you shouldn't be surprised that there is a Jabber client for Emacs, too. (If you are not of the Emacs persuasion, see this [[http://www.jabber.org/software/clients.shtml][list of Jabber clients]].) Jabber is, like e-mail, a decentralised system. A Jabber identifier (JID) is of the form =username@server=, just like an e-mail address, and every Jabber user whose server is open to Internet connections can communicate with any other user. This is in stark contrast to the legacy "walled-garden" IM systems, where you need a separate account for each system to be able to communicate with its users. Note that the [[http://talk.google.com][Google Talk]] service is an XMPP service, so if you have a GMail account, you already have a JID ending with =@gmail.com=. In Jabber, you have a "roster", a list of contacts. You can see which of them are online at the moment, and chat with them. (You can also send messages to an offline contact, and the message will be stored on the server for later delivery.) Jabber also supports IRC-style chat rooms. * What is jabber.el? jabber.el is a Jabber client for Emacs. It may seem strange to have a chat client in an editor, but consider that chatting is, after all, just a special case of text editing. * Downloading and installing ** Prepackaged Note that jabber.el is available as [[http://packages.debian.org/emacs-jabber][emacs-jabber in Debian]], and in [[http://packages.ubuntu.com/emacs-jabber][Ubuntu's "universe" section]]. ** Dependencies jabber.el requires either GNU Emacs 22, or GNU Emacs 21 combined with Gnus 5.10. You should get these from your distribution, or from the [[http://www.gnu.org/software/emacs/][Emacs]] and [[http://gnus.org][Gnus]] web sites. However, if you want to connect to servers that use SRV records (e.g. Google Talk), it is recommended to use either No Gnus or Gnus 5.13. If you want encrypted connections (some servers, e.g. Google Talk, require it), you need [[http://www.gnu.org/software/gnutls/][GnuTLS]] installed. ** Downloading Download the [[impatient][latest release]] and unpack it in a suitable location. Add something like the following to your =.emacs= file: #+BEGIN_EXAMPLE ;; adjust this path: (add-to-list 'load-path "/path/to/emacs-jabber") ;; For 0.7.1 and below: (require 'jabber) ;; For 0.7.90 and above: (require 'jabber-autoloads) #+END_EXAMPLE Either evaluate those lines, or restart Emacs. ** Using See the [[file:manual-0.7.1/Basic-operation.html][Basic Operation]] in the manual. * Reporting bugs Bug reports can be sent either to the mailing list [[http://lists.sourceforge.net/lists/listinfo/emacs-jabber-general][emacs-jabber-general]] or to the [[http://sourceforge.net/tracker/?group_id=88346&atid=586350][bug tracker]]. * Latest source jabber.el releases are, unfortunately, less frequent than they would be in an ideal world. You can get the latest development version using various version control systems. ** CVS See [[http://sourceforge.net/cvs/?group_id=88346][the Sourceforge CVS page]]. In short, run the following command: #+BEGIN_EXAMPLE cvs -z3 -d:pserver:anonymous@emacs-jabber.cvs.sourceforge.net:/cvsroot/emacs-jabber co -P emacs-jabber #+END_EXAMPLE ** GNU Arch The GNU Arch mirror is no longer being updated. ** git #+BEGIN_EXAMPLE git-clone git://git.catap.ru/emacs-jabber.git #+END_EXAMPLE * List of releases The list of releases has been moved to a [[file:list-of-releases.org][separate page]]. # Local variables: # mode: org # eval: (progn (add-to-list 'org-link-types "xmpp") (org-make-link-regexps)) # End: