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
- Screensharing (Windows, Mac, X11 only. Not supported under Wayland, see known issues below)
Remote control(currently disabled due to security issues)- Always-On-Top window
- Support for deeplinks such as
jitsi-meet://myroom(will openmyroomon the configured Jitsi instance) orjitsi-meet://jitsi.mycompany.com/myroom(will openmyroomon the Jitsi instance running onjitsi.mycompany.com)
Installation
Download our latest release and you're off to the races!
| Windows | macOS | GNU/Linux (AppImage) | GNU/Linux (Deb) |
|---|---|---|---|
| Download | Download | Download | Download |
NOTE: The GNU/Linux builds are 64-bit only.
Third-Party builds
Homebrew
For macOS user, you can install the application using the following command:
brew install --cask jitsi-meet
Development
If you want to hack on this project, here is how you do it.
Show building instructions
Installing dependencies
Install Node.js 16 first (or if you use nvm, switch to Node.js 16 by running nvm use).
Extra dependencies for Windows
npm install --global --production windows-build-toolsExtra dependencies for GNU/Linux
X11, PNG, and zlib development packages are necessary. On Debian-like systems, they can be installed as follows:
sudo apt install libx11-dev zlib1g-dev libpng-dev libxtst-devInstall all required packages:
npm installStarting in development mode
npm startThe debugger tools are available when running in dev mode, and can be activated with keyboard shortcuts as defined here.
They can also be displayed automatically with the application --show-dev-tools command line flag, or with the SHOW_DEV_TOOLS environment variable as shown:
SHOW_DEV_TOOLS=true npm startBuilding the production distribution
npm run distWorking with jitsi-meet-electron-sdk
jitsi-meet-electron-sdk 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 or tested, running with a local version of these utils is very handy.
By default, the @jitsi/electron-sdk is build from npm. The default dependency path in package.json is:
"@jitsi/electron-sdk": "^3.0.0"To work with a local copy, you must change the path to:
"@jitsi/electron-sdk": "file:///Users/name/jitsi-meet-electron-sdk-copy",To build the project, you must force it to take the sources, as npm update will
not do it.
npm install @jitsi/electron-sdk --forceNOTE: Also check the jitsi-meet-electron-sdk README to see how to configure
your environment.
Publishing
- Create release branch:
git checkout -b release-1-2-3, replacing1-2-3with the desired release version - Increment the version:
npm version patch, replacingpatchwithminorormajoras required - Push release branch to github:
git push -u origin release-1-2-3 - Create PR:
gh pr create - Once PR is reviewed and ready to merge, create draft Github release:
gh release create v1.2.3 --draft --title 1.2.3, replacingv1.2.3and1.2.3with the desired release version - Merge PR
- Github action will build binaries and attach to the draft release
- Test binaries from draft release
- If all tests are fine, publish draft release
Known issues
Windows
A warning that the app is unsigned will show up 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.
GNU/Linux
-
If you can't execute the file directly after downloading it, try running
chmod u+x ./jitsi-meet-x86_64.AppImage -
Under wayland, screensharing is not currently supported (due to electron/electron#37463), and the app will crash with a segfault!
-
On Ubuntu 22.04, the AppImage will fail with a fuse error (as the AppImage uses
libfuse2, while 22.04 comes withlibfuse3by default):dlopen(): error loading libfuse.so.2To fix this, install libfuse2 as follows:
sudo apt install libfuse2 -
If you experience a blank page after jitsi server upgrades, try removing the local cache files:
rm -rf ~/.config/Jitsi\ Meet/
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 or Ubuntu):
sudo apt-get install libnss3Translations
The JSON files are for all the strings inside the application, and can be translated here.
New translations require the addition of a line in index.js.
Localize desktop file on linux requires the addition of a line in package.json.
Please search for Comment[hu] as an example to help add your translation of the English string Jitsi Meet Desktop App for your language.
License
Apache 2. See the LICENSE file.
Community
Jitsi is built by a large community of developers. If you want to participate, please join the community forum.