Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/threema-ch/threema-web

The Threema Web application.
https://github.com/threema-ch/threema-web

angularjs messenger threema web webclient

Last synced: about 1 month ago
JSON representation

The Threema Web application.

Awesome Lists containing this project

README 

        
# Threema Web



[![Build status](https://img.shields.io/circleci/build/github/threema-ch/threema-web/master)](https://circleci.com/gh/threema-ch/threema-web)

[![License](https://img.shields.io/badge/License-AGPLv3-blue.svg)](https://github.com/threema-ch/threema-web/blob/master/LICENSE.txt)

[![Docker Image](https://img.shields.io/badge/docker%20image-threema%2Fthreema--web-yellow.svg)](https://hub.docker.com/r/threema/threema-web)



> :warning: **Note:** Threema Web is in maintenance mode while we are working

> on [Threema for Desktop 2.0](https://three.ma/md), which should resolve some

> of the long-standing issues we were having with Threema Web. We will still do

> regular maintenance and fix critical bugs, but for now there will be no major

> new features or non-critical bugfixes. See

> https://github.com/threema-ch/threema-web/pull/996 for more details.



Threema Web is a web client for Threema, a privacy-focussed end-to-end

encrypted mobile messenger hosted and developed in Switzerland. With Threema

Web, you can use Threema on your Desktop without compromising security.



[https://web.threema.ch/](https://web.threema.ch/)



![Screenshot](https://threema.ch/images/webclient_header.png)



Threema Web establishes a connection between Desktop and mobile device using

[WebRTC](https://webrtc.org/) (Android) or encrypted WebSockets (iOS).

Signaling and data is end-to-end encrypted with [SaltyRTC](https://saltyrtc.org/).



For more information, see the [Threema Cryptography

Whitepaper](https://threema.ch/press-files/2_documentation/cryptography_whitepaper.pdf).



## Bug Reports and Feature Requests



If you find a bug in Threema Web, feel free to [open an

issue](https://github.com/threema-ch/threema-web/issues/new) on GitHub. Please

make sure that your bug report hasn’t already been filed by using the search

function.



Note that Threema Web is in maintenance mode while we are working on a new

solution that should resolve some of the long-standing issues we were having

with Threema Web. We will still do regular maintenance and fix critical bugs,

but for now there will be no major new features or non-critical bugfixes.  See

https://github.com/threema-ch/threema-web/pull/996 for details.



## Beta Testing



We may occasionally deploy experimental branches on

[https://web-beta.threema.ch](https://web-beta.threema.ch) which you are

encouraged to test. If you encounter problems, please

[open an issue](https://github.com/threema-ch/threema-web/issues/new) and

include the experiment’s version number (e.g. `1.2.3-experiment-beta4`).



## Translating



If you want to help translate Threema Web to your language, please check out

[`TRANSLATING.md`](./TRANSLATING.md)!



## Protocol



The protocol used to communicate between the Threema app and Threema Web

is documented [here](https://threema-ch.github.io/app-remote-protocol/).



## Development



Threema Web is written using [TypeScript](https://www.typescriptlang.org/) and

[AngularJS 1](https://www.angularjs.org/). Dependencies are managed with

[npm](https://www.npmjs.com/). You currently need Node.js 18 to build Threema

Web. (Note that Node.js is only a build dependency, the result is plain old

client-side JavaScript.)



If your default NodeJS version is not 18, use nvm to install it:



    nvm install

    nvm use



Install development dependencies:



    npm install



Run the dev server:



    npm run devserver



Then open the URL in your browser:



    firefox http://localhost:9966



*(Note that this setup should not be used in production. To run Threema

Web on a server, please follow the instructions at

[docs/self_hosting.md](docs/self_hosting.md).)*



## Testing



To run unit tests:



    npm run build:unittests && npm run testserver

    firefox http://localhost:7777/tests/testsuite.html



To run UI tests:



    npm run build  # Required for CSS to be rebuilt

    npm run test:ui 



For example:



    npm run test:ui firefox

    npm run test:ui chrome



You can also filter the test cases:



    npm run test:ui firefox emoji



To run linting checks:



    npm run lint



You can also install a pre-push hook to do the linting:



    echo -e '#!/bin/sh\nnpm run lint' > .git/hooks/pre-push

    chmod +x .git/hooks/pre-push



## Configuration



The configuration of Threema Web can be tweaked in

[`src/config.ts`](src/config.ts) and [`src/userconfig.js`](src/userconfig.js) /

[`src/userconfig.overrides.js`](src/userconfig.overrides.js) (see

[`src/userconfig.overrides.js.example`](src/userconfig.overrides.js.example).

The config variables are defined at build time, and the userconfig variables

can be modified at runtime. Please refer to those files for documentation on

what variables exist and how to configure them.



In the Docker image, all userconfig variables can be overridden using env

variables. See [`docs/docker.md`](docs/docker.md) for more information.



## Self Hosting



For instructions on how to host your own version of Threema Web, please refer

to [docs/self_hosting.md](docs/self_hosting.md).



## Contributing



Contributions to Threema Web are welcome! Please open a pull request with your

proposed changes.



## Security



Every Threema Web release will be tagged. The git tags are cryptographically

signed using the following PGP key:



    pub   rsa4096 2016-09-06 [SC] [expires: 2026-09-04]

          E7AD D991 4E26 0E8B 35DF  B506 65FD E935 573A CDA6

    uid           Threema Signing Key 



The public key can be found [on Keybase](https://keybase.io/threema).



If you discover a security issue in Threema, please adhere to the coordinated

vulnerability disclosure model. To be eligible for a bug bounty, please [file a

report on GObugfree](https://app.gobugfree.com/programs/threema) (where all the

details, including the bounty levels, are listed). If you’re not interested in

the bug bounty program, you can contact us via Threema or by email; for contact

details, see [threema.ch/contact](https://threema.ch/en/contact) (section

“Security”).



## License



Threema Web license:



    Threema Web.



    Copyright © 2016-2023 Threema GmbH (https://threema.ch/).



    This program is free software: you can redistribute it and/or modify

    it under the terms of the GNU Affero General Public License as

    published by the Free Software Foundation, either version 3 of the

    License, or (at your option) any later version.



    This program is distributed in the hope that it will be useful,

    but WITHOUT ANY WARRANTY; without even the implied warranty of

    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

    GNU Affero General Public License for more details.



    You should have received a copy of the GNU Affero General Public License

    along with this program. If not, see .



For third party library licenses, see `LICENSE-3RD-PARTY.txt`.