This repository is part of the source code of Wire. You can find more information at wire.com or by contacting opensource@wire.com.

You can find the published source code at github.com/wireapp/wire.

For licensing information, see the attached LICENSE file and the list of third-party licenses at wire.com/legal/licenses/.

If you compile the open source software that we make available from time to time to develop your own mobile, desktop or web application, and cause that application to connect to our servers for any purposes, we refer to that resulting application as an “Open Source App”. All Open Source Apps are subject to, and may only be used and/or commercialized in accordance with, the Terms of Use applicable to the Wire Application, which can be found at https://wire.com/legal/#terms. Additionally, if you choose to build an Open Source App, certain restrictions apply, as follows:

a. You agree not to change the way the Open Source App connects and interacts with our servers; b. You agree not to weaken any of the security features of the Open Source App; c. You agree not to use our servers to store data for purposes other than the intended and original functionality of the Open Source App; d. You acknowledge that you are solely responsible for any and all updates to your Open Source App.

For clarity, if you compile the open source software that we make available from time to time to develop your own mobile, desktop or web application, and do not cause that application to connect to our servers for any purposes, then that application will not be deemed an Open Source App and the foregoing will not apply to that application.

No license is granted to the Wire trademark and its associated logos, all of which will continue to be owned exclusively by Wire Swiss GmbH. Any use of the Wire trademark and/or its associated logos is expressly prohibited without the express prior written consent of Wire Swiss GmbH.

Wire Desktop

Cross platform desktop app, wrapping the wire-webapp. Based on Electron.

Prerequisites

• Node.js matching the version defined in .node-version
• Npm
• Git
• Yarn (Install using the official instructions at https://yarnpkg.com/lang/en/docs/install/, and not using the package recommended by apt-get)

Install Dependencies

sudo apt install git npm nodejs
npm install --global yarn

Clone

git clone https://github.com/wireapp/wire-desktop.git
cd wire-desktop
yarn

Start

yarn start

Test

yarn test

Managed device configuration (MDM)

On company-managed devices, an MDM administrator can force App-lock on, overriding the team-level App-lock setting. The desktop app reads a single applockOverride flag at startup — without spawning any shell command — and forwards it to the webapp as window.desktopAppConfig.managedConfig.

The flag is read from organization-agnostic, Wire-vendor locations (no customer/company name is hardcoded):

Testing locally

For each OS: plant the flag, relaunch the app, then open DevTools on the webapp's <webview> and evaluate window.desktopAppConfig.managedConfig — expect {applockOverride: true}. With nothing planted it must be {applockOverride: false} and the app behaves as before.

Windows (elevated prompt):

reg add "HKLM\SOFTWARE\Policies\Wire" /v applockOverride /t REG_DWORD /d 1 /f
:: relaunch app -> applockOverride === true
reg delete "HKLM\SOFTWARE\Policies\Wire" /f

Enrollment is detected automatically on an Intune/MDM-enrolled or Azure-AD-joined machine (no Policies\Wire value needed).

macOS (use the running build's bundle id — production is com.wearezeta.zclient.mac; dev/internal differ):

defaults write com.wearezeta.zclient.mac applockOverride -bool true
# relaunch app -> applockOverride === true
defaults delete com.wearezeta.zclient.mac applockOverride

To validate the real MDM path (managed-preferences domain):

sudo defaults write "/Library/Managed Preferences/com.wearezeta.zclient.mac.plist" applockOverride -bool true

Linux:

echo '{"applockOverride": true}' | sudo tee /etc/wire/managed.json
# relaunch app -> applockOverride === true
sudo rm /etc/wire/managed.json

Deployment

Compare Views

1. Updates from "dev" to "staging" (changelog): https://github.com/wireapp/wire-desktop/compare/staging...dev
2. Updates from "staging" to "main" (changelog): https://github.com/wireapp/wire-desktop/compare/main...staging

Tasks

# Build for macOS
yarn build:macos
# Build for Windows
yarn build:win
# Build for Linux
yarn build:linux

Other Linux targets

If you would like to build for another Linux target, run the following command:

export LINUX_TARGET=<target>
yarn build:linux

Replace <target> with your desired target (e.g. rpm). Have a look at the documentation for electron-builder for the available targets. Multiple targets can be combined by comma separation (e.g. rpm,deb). Note that we cannot offer support for uncommon targets.

Furthermore, you can disable asar packaging (not recommended, but e.g. needed for target dir) by setting ENABLE_ASAR="false" before building. Example:

export ENABLE_ASAR="false"
yarn build:linux

Troubleshooting

If you are having troubles building Wire for Desktop, then our troubleshooting page might be of help.

Translations

All Wire translations are crowdsourced via Crowdin.

Install wire-desktop under Linux

You can of course use the webapp in your browser, but if you prefer to install wire-desktop, continue reading here:

https://github.com/wireapp/wire-desktop/wiki/How-to-install-Wire-for-Desktop-on-Linux