Skip to main content

The Internet Encryption Toolkit: Encrypted Internet Proxy and Encrypted Mail.

Project description


Your internet encryption toolkit Documentation Status IRC IRC-es

Bitmask is the client for the services offered by the LEAP Platform. It contains a command-line interface and a multiplatform desktop client. It can be also used as a set of libraries to communicate with the different services from third party applications.

It is written in python using Twisted and licensed under the GPL3. The Graphical User Interface is written in html+js and uses PyQt5 for serving the application.

Package under development!

The previous client using PySide has been deprecated (Bitmask version 0.9.2, still available at the repo).

Read the Docs!

There is documentation about Bitmask for users and for developers.


Please report any bugs in our bug tracker.


If you want to watch the logs, from the command line:

bitmaskctl logs watch

The paste command can be handy to do bug reports (needs pastebinit installed in the system):

bitmaskctl logs send


Running Tests

You need tox to run the tests. If you don’t have it in your system yet:

pip install tox

And then run all the python tests:


There are some minimal end-to-end tests:

make test_e2e

For testing the UI (aka bitmask-js) you need to have mocha installed. You can run ui tests like this:

cd ui && make test

More info abou testing can be found in the docs/hacking/testing document.


In order to run bitmask in a development environment, you must activate a virtualenv and install the various packages using pip install -e. This installs python packages as links to the source code, so that your code changes are immediately reflected in the packages installed in the virtualenv.

The various make dev-* commands will run the appropriate pip install commands for you.

If you want to setup your whole development environment, and you are running a debian-based system, you can try:

make dev-bootstrap

To upgrade regularly the python dependencies installed inside your virtualenv, you can run:

make upgrade-all

inside your virtualenv, and it will install any new version of your dependencies that is found in pypi.

Check out the docs/hacking sections for more extense instructions to get you started.


Bitmask is released under the terms of the GNU GPL version 3 or later.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for leap.bitmask, version 0.10.1
Filename, size File type Python version Upload date Hashes
Filename, size leap.bitmask-0.10.1-py2-none-any.whl (296.9 kB) File type Wheel Python version 2.7 Upload date Hashes View
Filename, size leap.bitmask-0.10.1.tar.gz (228.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page