Jitsi Meet desktop application powered by

Go to file

bsimml db6d976ae2 Allow mailto links to be opened externally		2021-03-23 16:21:16 +01:00
.github	Add GH Action to run the linter	2020-07-02 08:51:34 +02:00
app	Allow mailto links to be opened externally	2021-03-23 16:21:16 +01:00
patches	Add Apple Silicon support	2021-03-10 00:34:30 +01:00
resources	Enhancements to make it more Mac App Store (mas) compatible	2021-03-15 00:20:20 +01:00
.eslintignore	Update bundled external API	2021-03-03 16:58:05 +01:00
.eslintrc.js	Updated eslint-config-jitsi	2018-06-11 08:26:57 +02:00
.flowconfig	Update dependencies	2018-12-27 16:56:51 +00:00
.gitignore	Configured electron-builder for app release	2018-07-05 21:00:19 +02:00
.nvmrc	Define Node.js 12 as requirement	2020-06-26 10:06:01 +02:00
.travis.yml	Fix Travis CI build	2021-03-10 00:34:30 +01:00
LICENSE	Initial commit	2016-12-12 14:52:17 -06:00
README.md	Switch mac build to universal build	2021-03-15 00:13:00 +01:00
SECURITY.md	Add SECURITY.md	2020-06-02 09:54:20 +02:00
appveyor.yml	Update CI Tools	2020-04-07 14:30:36 +02:00
entitlements.mac.plist	Fix Camera permissions for signed Apps	2020-05-26 09:39:41 +02:00
main.js	Enhancements to make it more Mac App Store (mas) compatible	2021-03-15 00:20:20 +01:00
package-lock.json	Switch mac build to universal build	2021-03-15 00:13:00 +01:00
package.json	Enhancements to make it more Mac App Store (mas) compatible	2021-03-15 00:20:20 +01:00
screenshot.png	Update README	2018-08-14 09:37:08 +02:00
webpack.main.js	fix security issue / update deps	2020-04-07 14:30:36 +02:00
webpack.renderer.js	Update dependencies	2021-02-23 14:22:54 +01:00

README.md

Jitsi Meet Electron

Desktop application for Jitsi Meet built with Electron.

Features

End-to-End Encryption support (BETA)
Works with any Jitsi Meet deployment
Builtin auto-updates
~Remote control~ (currently disabled due to security issues)
Always-On-Top window
Support for deeplinks such as jitsi-meet://myroom (will open myroom on the configured Jitsi instance) or jitsi-meet://jitsi.mycompany.com/myroom (will open myroom on the Jitsi instance running on jitsi.mycompany.com)

Installation

Download our latest release and you're off to the races!

Windows	macOS	GNU/Linux (64-bit only)
Download	Download	Download

Third-Party builds

Homebrew

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

brew install --cask jitsi-meet

Using it with your own Jitsi Meet installation

⚠️ The following additional HTTP headers are known to break the Electron App:

Content-Security-Policy "frame-ancestors [looks like any value is bad]";
X-Frame-Options "DENY";

A working Content Security Policy looks like that:

Content-Security-Policy "img-src 'self' 'unsafe-inline' data:; style-src 'self' 'unsafe-inline'; font-src 'self'; object-src 'none'; base-uri 'self'; form-action 'none';";

Development

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

Show building instructions

Installing dependencies

Install Node.js 12 first (or if you use nvm, switch to Node.js 12 by running nvm use).

Extra dependencies for Windows

npm install --global --production windows-build-tools
npm config set msvs_version 2017

Extra dependencies for GNU/Linux

X11, PNG and zlib development packages are necessary. On Debian-like systems then can be installed as follows:

sudo apt install libx11-dev zlib1g-dev libpng-dev libxtst-dev

Install all required packages:

npm install

Starting in development mode

npm start

The debugger tools are available when running in dev mode and can be activated with keyboard shortcuts as defined here https://github.com/sindresorhus/electron-debug#features.

It can also be displayed automatically from the SHOW_DEV_TOOLS environment variable such as:

SHOW_DEV_TOOLS=true npm start

or from the application --show-dev-tools command line flag.

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.

Known issues

Windows

A warning will show up mentioning the app is unsigned upon first install. This is expected.

macOS

On macOS Catalina a warning will be displayed on first install. The app won't open unless "open" is pressed. This dialog is only shown once. Builtin auto-updates are not yet handled in macOS due to unsigned build.

GNU/Linux

There is a known issue which prevents the app from starting on some Linux distributions: #231

If after downloading it, you can't execute the file directly, try running chmod u+x ./jitsi-meet-x86_64.AppImage

The workaround for now is to launch the app like so: ./jitsi-meet-x86_64.AppImage --no-sandbox

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

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.