Introduction

JSCommunicator is a WebRTC communication tool developed in HTML, CSS and JavaScript. It supports voice, video and chat messaging using the SIP protocol over WebSockets.

Please see http://jscommunicator.org for more details about features, examples, mailing lists and the latest source code.

Server requirements

To use JSCommunicator, you require a SIP proxy that supports the SIP over WebSockets transport.

Only recent versions of the SIP proxies support WebSockets.

repro from reSIProcate http://www.resiprocate.org

Kamailio http://www.kamailio.org

See the Real-Time Communication Quick Start Guide for details about setting up a SIP and TURN server to support WebRTC calls.

Dependencies

You need to have the following JavaScript libraries available in your web server or CMS:

JsSIP The latest code on the JSCommunicator master branch works with JsSIP version 0.6.x

jQuery (v1.4 or greater has been tested)

jQuery UI

jQuery.i18n.properties

ArbiterJS (v1.0 has been tested)

Font Awesome (v4.1 or greater has been tested, earlier versions do not work)

All dependencies can be easily fetched using either of the following methods:

• on a Debian/Ubuntu system, use the "deb-setup.sh" script

• on other systems, see the "code_grabber" script

Getting started

For integration in static or dynamically generated web sites, frameworks and Content Management Systems, please see INTEGRATION.md

Use cases

• Standalone:

  • include the HTML fragment into a static HTML page, possibly using Server Side Includes (SSI). Make sure the page references all the required JavaScript source files.

• In a CMS, wiki or other publishing platform:

  • include the HTML fragment into a block in a page managed by a CMS. Configure the CMS to send the JavaScript to the user or include Githubissues.
  • Githubissues is a development platform for aggregating issues.