= palaver =

   ''\puh-LAV-uhr; puh-LAH-vur\, noun:''
   

   ''Idle talk''

   ''A parley usually between persons of different backgrounds or cultures or levels of sophistication; a talk; hence, a public conference and deliberation.
''

'''palaver''' is a multi-user chat component for Jabber and XMPP servers.  The
intention is to support all features of [http://www.xmpp.org/extensions/xep-0045.html XEP-0045] as well as the relevant extended
discovery features of [http://www.xmpp.org/extensions/xep-0128.html XEP-0128].

'''palaver''' is written in [http://python.org Python] using the [http://twistedmatrix.com Twisted framework] for Internet
applications.  It is licensed under the open source MIT license.

The main inspiration for writing '''palaver''' was to replace JCR mu-conference.
While mu-conference has served the community well, it's lack of maintenance
has left many searching for a replacement.


== Features ==

Currently all basic multi-user chat features are supported, including some extra things like ban lists.  More features are on the way, and the intention is to fully support the entire protocol.
Specific information on protocol features can be found in source:trunk/XEP.txt#latest.
 
There is also [wiki:Plugins] support for extending different features of palaver. 

== Licensing ==

'''palaver''' is licensed under the MIT open source license.  It is free to use, modify and distribute by commercial and non-commercial users and developers.

== Obtaining ==

To download the latest version of '''palaver''' please click below or see the DownloadPage.

The current version of '''palaver''' is '''0.6'''.

 * [http://code.stanziq.com/cgit/palaver/palaver/snapshot/palaver-0.6.tar.gz palaver 0.6 tarball source]
 * [http://code.stanziq.com/cgit/palaver/palaver/snapshot/palaver-0.6.zip palaver 0.6 zipped source]

You can also grab the latest development version from the subversion repository:

{{{
git clone git://code.stanziq.com/palaver
}}}

The master branch is also available for download without the need for git.

 * http://code.stanziq.com/cgit/palaver/palaver/snapshot/palaver-master.zip
 * http://code.stanziq.com/cgit/palaver/palaver/snapshot/palaver-master.tar.gz
 * http://code.stanziq.com/cgit/palaver/palaver/snapshot/palaver-master.tar.bz2

== Building and Running ==

Build instruments and other documentation can be found in source:trunk/README.txt#latest.

== Convert from legacy spool to new spool. ==

If you would like to convert your old mu-conference spool into
palaver's spool format then you can run a convert script provided
in palaver's util directory.

{{{ python util/legacyspool.py /var/lib/jabberd/old-mu-conference /var/lib/jabberd/new-conference }}}

This will convert and move the new spool format into a new directory.
You can leave the new directory out and it will put the new format in with the
old format.


== Convert from legacy spool to new postgresql backend. ==

If you would like to convert your old mu-conference spool into
palaver's postgresql backend then you can run a convert script provided
in palaver's util directory.

{{{ python util/legacypgsql.py /var/lib/jabberd/old-mu-conference -c ./config.xml }}}

This will convert the data and insert it into the database. You will need to set up the database first.


== Bug Reports, Contributing and Feedback ==

Bugs can be reported by clicking on ''New Ticket'' in the navigation bar above.  Please be as detailed as possible and include your email address when submitting bugs.

You can also join the mailing list on google groups:

http://groups.google.com/group/palaver-xmpp