/jitsi-meet-electron

Jitsi Meet desktop application powered by :electron:

Primary LanguageJavaScriptApache License 2.0Apache-2.0

Jitsi Meet Electron

Desktop application for Jitsi Meet built with Electron.

Features

  • Works with any Jitsi Meet deployment
  • Local settings
  • Builtin auto-updates
  • Remote control
  • Always-On-Top window

Installation

Download our latest release and you're off to the races! The supported platforms are macOS, Windows (both 32 and 64bits) and GNU/Linux (64bits only).

NOTE for old GNU/Linux distributions

You might get the following error:

FATAL:nss_util.cc(632)] NSS_VersionCheck("3.26") failed. NSS >= 3.26 is required.
Please upgrade to the latest NSS, and if you still get this error, contact your
distribution maintainer.

If you do, please install NSS (example for Debian / Ubuntu):

sudo apt-get install libnss3

Homebrew

For MacOS user, you can install the application using the following command:

brew cask install jitsi-meet

Using it with your own Jitsi Meet installation

In order to use this application with your own Jitsi Meet installation it's necessary to enable the External API. Your server must serve a external_api.js file at the root of the installation.

Here is an example using nginx:

location /external_api.js {
    alias /usr/share/jitsi-meet/libs/external_api.min.js;
}

The following additional HTTP header are known not work with the Electron App:

Content-Security-Policy "frame-ancestors 'none'";
X-Frame-Options "DENY";

Development

If you want to hack on this project, here is how you do it.

Show building instructions

Installing dependencies

npm install

Starting in development mode

npm start

Building the production distribution

npm run dist

Working with jitsi-meet-electron-utils

jitsi-meet-electron-utils is a helper package which implements many features such as remote control and the always-on-top window. If new features are to be added / tested, running with a local version of these utils is very handy, here is how to do that.

By default the jitsi-meet-electron-utils is build from its git repository sources. The default dependency path in package.json is:

"jitsi-meet-electron-utils": "jitsi/jitsi-meet-electron-utils"

To work with local copy you must change the path to:

"jitsi-meet-electron-utils": "file:///Users/name/jitsi-meet-electron-utils-copy",

To build the project you must force it to take the sources as npm update will not do it.

npm install jitsi-meet-electron-utils --force

NOTE: Also check the jitsi-meet-electron-utils README to see how to configure your environment.

License

Apache 2. See the LICENSE file.

Community

Jitsi is built by a large community of developers, if you want to participate, please join community forum.