Your internet encryption toolkit
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.
Package under development!
The previous client using PySide has been deprecated (Bitmask version 0.9.2, still available at the http://github.com/leapcode/bitmask_client repo).
Read the Docs!
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
in the system):
bitmaskctl logs send
but do not upload anything that you do not want to make public ;)
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:
For testing the UI (aka
bitmask-js) you need to have
installed. You can run ui tests like this:
cd ui && make test
More info abou testing can be found in the
In order to run bitmask in a development environment, you must activate a
virtualenv and install the various leap-related python packages using
install -e. This installs them as links to the source code, so
that your code changes are immediately reflected in the packages imported from
within the virtualenv.
make dev-* commands will run the appropriate
commands for you.
If you want to setup your whole development environment in a single step, and you are running a debian-based system, you can use:
pew workon bitmask
To upgrade regularly the python dependencies installed inside your virtualenv, you can run:
inside your virtualenv, and it will install any new version of your dependencies that is found in pypi.
Check out the
docs/hacking page for more extense instructions to get
Bitmask is released under the terms of the GNU GPL version 3 or later.