/wire

:wavy_dash: Overview of the open source code for Wire

GNU General Public License v3.0GPL-3.0

Wire™

Wire logo

Open source

The privacy page and the privacy and security whitepapers explain the details of the encryption algorithms and protocols used.

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

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.

Build your own Wire client

iOS

See wire-ios

Android

See wire-android (legacy version) and wire-android-reloaded (modern version)

Desktop

See wire-desktop

Wire for Web

See wire-webapp

Components

AVS

The audio, video, and signaling (AVS) library of Wire is developed in ANSI C/C++. The code is cross compiled for Android and iOS. Wrappers for interaction with upstream modules are written in Java for Android and Objective-C for iOS.

Repositories

  • avs: Audio-video library for calling (mostly C), then cross compiled for iOS and Android

Proteus/Cryptobox

The Axolotl protocol implementation and other cryptographic and utility libraries are developed in Rust, then cross-compiled for iOS and Android. The web version has its own port of these libraries in JavaScript.

Repositories

  • proteus: Axolotl Protocol Implementation in Rust, then cross compiled for iOS and Android
  • cryptobox: High-level API with persistent storage for proteus
  • cryptobox-haskell: Haskell bindings to cryptobox
  • cryptobox-c: C-FFI to cryptobox
  • hkdf: HKDF implementation (RFC 5869) in Rust, then cross compiled to iOS and Android

Server

The Wire server components can be found in the wire-server repository.

Common definitions

Protocol buffer definitions are used by all clients to communicate with each other and with the backend.

Repositories

  • generic-message-proto: Protocol buffer definitions that are part of the cross-platform client communication protocol
  • backend-api-protobuf: Protocol buffer definitions that are part of the backend communication protocol

Contributions

You can contribute to Wire in several ways:

Finding bugs

If you find a bug in how Wire apps work, please submit a ticket to our support and we will keep you informed about the progress.

Contributing to the code

If you wish to contribute source code to one of our repositories you have to sign our Contributor Agreement first.

We accept only bug fixes and code improvements. We cannot accept new features, UI or UX changes – these are decided on and built by the Wire development team.

When you submit your first pull request, you can sign the agreement electronically by filling in the required information. You will not have to sign it again for subsequent pull requests from the same GitHub account.

Translating the apps

You can help with the crowdsourced translations of Wire apps on Crowdin.