Skip to content


Subversion checkout URL

You can clone with
Download ZIP
XMPP/Jabber Library for Ruby - please use:
Ruby Shell
#43 Compare This branch is 82 commits behind xmpp4r:master.
Failed to load latest commit information.
data/doc/xmpp4r/examples Fixes for file transfer
lib Merge branch 'master' of git://
tools Moved GitHub gemspec test script to tools dir.
website Update website for 0.5
.gitignore .gitignore: add emacs backup files
CHANGELOG Release version 0.5
COPYING Verbose documentation of the exception block
LICENSE De-tabbify LICENSE file. Whitespace.
README.rdoc Added Jacob to README.rdoc
README_ruby19.txt Renamed file so it doesn't show as the default readme on GitHub.
Rakefile Release version 0.5
Release_Checklist Added a release checklist
setup.rb Whitespace cleanup. Strip trailing whitespace and convert leading tab…
xmpp4r.gemspec added support for XEP 202 entity time:…



Project Home

You can find info about the xmpp4r project and how to contribute at the project home page:

If you need to ask questions, or want feedback on proposed changes please feel free to ask them on the '' mailing list. You can join or view archives of the mailing list at:

If you are having a problem and would like to report it to the mailing list please include a protocol dump which can be enabled in your code with:

Jabber::debug = true


Lucas Nussbaum <>
Stephan Maka <>
Kirill A. Shutemov <>
Glenn Rempe <>
Jacob Burkhart <>
Yuki Mitsui
Peter Schrammel
Vojtech Vobr
Andreas Wiese
Chris Zelenak
Matthew Wood
Sam Ruby
Tim Carey-Smith
Scott Lillibridge
Joshua Sierles
Ripta Pasay <>
Seth Fitzsimmons

Source Code

The source for xmpp4r is managed using the Git SCM and can be found in our project page:


There are a number of ways that you can install xmpp4r depending on your needs and the methods you prefer.

Install over the network using RubyGems

You can install the current release of the xmpp4r library from a stable release gem on RubyForge using RubyGems:

sudo gem install xmpp4r

Install over the network using a Debian package

You can install the current release of the xmpp4r library from a stable release copy on your .deb friendly linux system (e.g. Debian or Ubuntu) using apt:

sudo apt-get install libxmpp4r-ruby

Install from local source code (Developers Only)

If you have a local Git clone of the source repository or a tarball you can install xmpp4r using several methods. First you'll need to get a local copy.

Clone the Git repository (recommended):

git clone git://

OR download a stable release tarball from:

OR download a snapshot of the latest source in .tar.gz format from:

Install : Using Rake

# Show all available rake tasks
cd xmpp4r/
rake -T

# Package up the gem file and install it
rake gem:install

Install : Using setup.rb

This will install a copy of the library in your Ruby path and does not require RubyGems to be installed.

cd xmpp4r/


XMPP4R is released under the Ruby license (see the LICENSE file), which is compatible with the GNU GPL (see the COPYING file) via an explicit dual-licensing clause.

Something went wrong with that request. Please try again.