xmpp.chapril.org-conversejs/README.md
greenkeeper[bot] 247148648e Update dependencies to enable Greenkeeper 🌴 (#877)
* chore(package): update dependencies
* docs(readme): add Greenkeeper badge
2018-01-05 11:24:20 +00:00

5.8 KiB

converse.js

Greenkeeper badge

Travis Bountysource bounties Translation status

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.

Please support this project via Patreon or Liberapay

Demo

Converse.js is hosted and can be used at https://conversejs.org.

A demo showing anonymous login is available at https://conversejs.org/demo/anonymous.html and a demo which shows how you can embed a single chat room into a page is avialable at https://conversejs.org/demo/embedded.html.

Converse.js: As seen on the conversejs.org website

Screenshot of Converse.js

inVerse: a fullscreen version of converse.js

Converse.js is also available in a fullscreen version, called inVerse

Screenshot of inVerse

Documentation

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

You'll probably want to begin with the quickstart guide, which shows you how to use the CDN (content delivery network) to quickly get a demo up and running.

Features

  • A plugin architecture based on pluggable.js
  • Single-user chat
  • Contacts and groups
  • Multi-user chat rooms XEP 45
  • Direct invitations to chat rooms XEP 249
  • vCard support XEP 54
  • Service discovery XEP 30
  • In-band registration XEP 77
  • Chat room bookmarks XEP 48
  • Roster item exchange XEP 144
  • Chat statuses (online, busy, away, offline)
  • Custom status messages
  • Desktop notifications
  • Typing and state notifications XEP 85
  • Messages appear in all connnected chat clients XEP 280
  • Third person "/me" messages XEP 245
  • XMPP Ping XEP 199
  • Server-side archiving of messages XEP 313
  • Client state indication XEP 352
  • Off-the-record encryption
  • Translated into 16 languages

Integration into other frameworks

Screencasts

Note: These screencasts are already quite old! Converse.js has grown and evolved further since then.

Tests

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

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

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.