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.
Threema Web establishes a direct connection between Desktop and mobile device using WebRTC. Signaling is end-to-end encrypted with SaltyRTC. If both devices are in the same network, no server is involved when synchronizing messages between the devices, and the digital footprint is reduced to the bare minimum.
For more information, see the Threema Web Whitepaper.
Install development dependencies:
Run the dev server:
npm run serve:live
Then open the URL in your browser:
(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.)
To run tests:
npm run build chromium tests/testsuite.html
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
The configuration of Threema Web can be tweaked in
SELF_HOSTED: Set this to
trueif this instance of Threema Web isn't being hosted on
SALTYRTC_HOST: Set this to the hostname of the SaltyRTC server that you want to use. If set to
null, the hostname will be constructed based on the
SALTYRTC_PORT: The port of the SaltyRTC server to be used.
SALTYRTC_SERVER_KEY: The public permanent key of the SaltyRTC server. Set this value to
nullif your server does not provide a public permanent key, or if you don't want to verify it.
SALTYRTC_STUN: Configuration object for the WebRTC STUN server.
SALTYRTC_TURN: Configuration object for the WebRTC TURN server.
PUSH_URL: The server URL used to deliver push notifications to the app.
For instructions on how to host your own version of Threema Web, please refer to docs/self_hosting.md.
Contributions to Threema Web are welcome! Please open a pull request with your proposed changes.
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 <firstname.lastname@example.org>
If you discover a security issue in the Threema Web, please follow responsible
disclosure and report it directly to
email@example.com instead of opening
an issue on Github.
pub rsa4096 2017-02-08 [SC] [expires: 2022-02-07] 677E 0E97 1669 53B3 2620 D95C 71B9 C6BA C55A 9855 uid Threema Security <firstname.lastname@example.org>
You can find both public keys and their proofs on keybase.
Threema Web. Copyright © 2016-2017 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 <http://www.gnu.org/licenses/>.