README

Converse is a modern, feature-rich and 100% client-side XMPP chat app that runs in a web browser. It can be used as a standalone web app or seamlessly integrated into existing websites.

Join our chat room (XMPP URL: discuss@conference.conversejs.org).

Quick Start

Try the hosted app at conversejs.org. You can also download and install Converse Desktop or Converse Tauri.

Or set up your own instance:

git clone git@github.com:conversejs/converse.js.git
npm install
npm run build
npm run serve -- -p 8008

You can then open http://localhost:8008/dev.html in your browser to access Converse.

See our quickstart guide for more details.

Screenshots

Live Demos

• Main App: Try the full application
• Anonymous Login: Test without creating an account
• Embedded Chat Room: See how to embed a single chat room

Documentation

Comprehensive documentation is available at conversejs.org/docs/html, including:

• Quickstart Guide
• Configuration Options
• Plugin Development

Key Features

• Multiple UI Options: Overlay chat boxes, full-page application, or embedded components
• Rich Messaging: Message styling, corrections, reactions, and URL previews
• Privacy-Focused: End-to-end encryption with OMEMO
• User Status: Custom status messages and availability indicators
• Notifications: Desktop notifications for new messages
• File Sharing: HTTP File Upload support
• Extensible: Plugin architecture based on pluggable.js
• Internationalized: Translated into 40+ languages
• Anonymous Login: Use without registration (server permitting)
• Responsive: Works on desktop and mobile devices

Display Modes

Converse adapts to your needs with multiple display options:

XMPP Protocol Support

Converse implements a wide range of XMPP Extensions (XEPs), making it one of the most protocol-compliant web clients available.

Integration Options

Converse integrates with popular platforms and frameworks:

XMPP Servers

Web Frameworks & CMS

Support the Project

If you find Converse useful, please consider supporting its development:

• GitHub Sponsors
• Patreon
• Liberapay

Thanks to everyone who has supported this project over the years through donations, testing, bug reports, and code contributions.

Sponsors