1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
|
# Jitsi Meet Electron
Desktop application for [Jitsi Meet] built with [Electron].
## Features
- [End-to-End Encryption](https://jitsi.org/blog/e2ee/) 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](https://github.com/jitsi/jitsi-meet-electron/issues/483) due to [security issues](https://github.com/jitsi/security-advisories/blob/master/advisories/JSA-2020-0001.md))
- 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 (AppImage) | GNU/Linux (Deb) |
| -- | -- | -- | -- |
| [Download](https://github.com/jitsi/jitsi-meet-electron/releases/latest/download/jitsi-meet.exe) | [Download](https://github.com/jitsi/jitsi-meet-electron/releases/latest/download/jitsi-meet.dmg) | [x64_64](https://github.com/jitsi/jitsi-meet-electron/releases/latest/download/jitsi-meet-x86_64.AppImage) [arm64](https://github.com/jitsi/jitsi-meet-electron/releases/latest/download/jitsi-meet-arm64.AppImage) | [x86_64](https://github.com/jitsi/jitsi-meet-electron/releases/latest/download/jitsi-meet-amd64.deb) [arm64](https://github.com/jitsi/jitsi-meet-electron/releases/latest/download/jitsi-meet-arm64.deb) |
NOTE: The GNU/Linux builds are 64-bit only.
### Third-Party builds
[<img src="https://dl.flathub.org/assets/badges/flathub-badge-en.svg"
alt="Download On Flathub"
height="60">](https://flathub.org/apps/details/org.jitsi.jitsi-meet)
### 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.
<details><summary>Show building instructions</summary>
#### Installing dependencies
Install Node.js 16 first (or if you use [nvm](https://github.com/nvm-sh/nvm), switch to Node.js 16 by running `nvm use`).
<details><summary>Extra dependencies for Windows</summary>
```bash
npm install --global --production windows-build-tools
```
</details>
<details><summary>Extra dependencies for GNU/Linux</summary>
X11, PNG, and zlib development packages are necessary. On Debian-like systems, they can be installed as follows:
```bash
sudo apt install libx11-dev zlib1g-dev libpng-dev libxtst-dev
```
</details>
Install all required packages:
```bash
npm install
```
#### Starting in development mode
```bash
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).
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:
```bash
SHOW_DEV_TOOLS=true npm start
```
#### Building the production distribution
```bash
npm run dist
```
#### Working 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:
```json
"@jitsi/electron-sdk": "^3.0.0"
```
To work with a local copy, you must change the path to:
```json
"@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.
```bash
npm install @jitsi/electron-sdk --force
```
NOTE: Also check the [`jitsi-meet-electron-sdk` `README`] to see how to configure
your environment.
#### Publishing
1. Create release branch: `git checkout -b release-1-2-3`, replacing `1-2-3` with the desired release version
2. Increment the version: `npm version patch`, replacing `patch` with `minor` or `major` as required
3. Push release branch to github: `git push -u origin release-1-2-3`
4. Create PR: `gh pr create`
5. Once PR is reviewed and ready to merge, create draft Github release: `gh release create v1.2.3 --draft --title 1.2.3`, replacing `v1.2.3` and `1.2.3` with the desired release version
6. Merge PR
7. Github action will build binaries and attach to the draft release
8. Test binaries from draft release
9. If all tests are fine, publish draft release
</details>
## 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 currently buggy:
* The app will crash on stopping screensharing
* When trying to start screensharing under wayland, 2 permission popups will show up. In both, something needs to be allowed, then in the following jitsi-internal selector, be quick (<2 seconds) to select a screen or application to start the screensharing. If you take longer, then the permission pupups will come again. If you cancel one of the permission popups, screensharing cannot be started successfully. These issues are known to the electron project and currently a limitation of electron under wayland. Use a browser to share your screen with wayland. X11 is not affected by this.
* On Ubuntu 22.04, the AppImage will fail with a fuse error (as the AppImage uses `libfuse2`, while 22.04 comes with `libfuse3` by default):
```
dlopen(): error loading libfuse.so.2
```
To 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/
```
<details><summary>NOTE for old GNU/Linux distributions</summary>
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):
```bash
sudo apt-get install libnss3
```
</details>
## Translations
The JSON files are for all the strings inside the application, and can be translated [here](/app/i18n/lang).
New translations require the addition of a line in [index.js](/app/i18n/index.js).
`Localize desktop file on linux` requires the addition of a line in [package.json](/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].
[Jitsi Meet]: https://github.com/jitsi/jitsi-meet
[Electron]: https://electronjs.org/
[latest release]: https://github.com/jitsi/jitsi-meet-electron/releases/latest
[`jitsi-meet-electron-sdk`]: https://github.com/jitsi/jitsi-meet-electron-sdk
[`jitsi-meet-electron-sdk` `README`]: https://github.com/jitsi/jitsi-meet-electron-sdk/blob/master/README.md
[community forum]: https://community.jitsi.org/
[LICENSE]: LICENSE
|
