README.rst

converse.js

Converse.js is a web based XMPP/Jabber instant messaging client.

It enables you to add chat functionality to your website, independent of any specific backend. You will however need an XMPP server to connect to, either your own, or a public one.

Features

It has the following features:

• Single-user chat
• Multi-user chat in chatrooms
• vCard support
• Service discovery
• Contact rosters
• Manually or automically subscribe to other contacts
• Accept or decline contact requests
• Roster item exchange
• Chat statuses (online, busy, away, offline)
• Custom status messages
• Typing notifications
• Third person messages (/me )
• Translated into multiple languages (af, de, en, es, fr, he, hu, id, it, ja, nl, pt_BR, ru)
• Off-the-record encryption support (via OTR.js)

Screencasts

• In a static HTML page. Here we chat to external XMPP accounts on Jabber.org and Gmail.
• Integrated into a Plone site via collective.xmpp.chat.
• Off-the-record encryption in Converse 0.7.

Integration into other frameworks

• Plone:

  collective.xmpp.chat is an add-on for Plone that uses Converse.js. Together with collective.xmpp.core, it provides for single-signon-support (SSO) and also enables you to manually or automatically register your Plone users onto your XMPP server.

• Django:

  django-conversejs is an app that makes it easer to integrate Converse.js into Django.

• Roundcube:

  roundcube-converse.js-xmpp-plugin is a plugin for Roundcube Webmail.

• Wordpress:

  ConverseJS

• Patternslib:

  patterns.converse: patterns.converse provides a Patternslib pattern for Converse.js

Demo

A live demo is available at https://conversejs.org

Tests

We use behavior-driven tests written with jasmine.js.

Open tests.html in your browser, and the tests will run automatically.

Documentation

The developer/integrator documentation can be found at https://conversejs.org/docs/html.

Licence

Converse.js is released under the Mozilla Public License (MPL).

Support

For support queries and discussions, please join the mailing list: conversejs@librelist.com

Also take a look at the mailing list archives.

Issues can be logged on the Github issue tracker.

Donations and tips are appreciated

• Bitcoin: 16FsPqE9DhFTryxrUenpsGX4LJ1TPu8GqS