Mirror of BitMask VPN from "authoritative" source as per bitmask.net https://bitmask.net
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Ruben Pollan 42593eb084
[i18n] Update locales
4 months ago
branding [pkg] fix upgrade from 0.20.1 4 months ago
cmd [i18n] Update locales 4 months ago
docker [pkg] add package_in_docker targets 4 months ago
docs [docs] document the new package release process 4 months ago
helpers [feat] bitmask-root: search for the system commands in the common paths 6 months ago
icon [bug] allow to fail on cleanup 1 year ago
locales [i18n] Update locales 4 months ago
packages/w32 [pkg] need to vendorize allendang w32 lib 1 year ago
pkg [bug] switch to keybase go-ps implementation 4 months ago
tools/transifex [locales] add romanian 1 year ago
.gitignore [pkg] ignore deploy folder 1 year ago
.gitlab-ci.yml [pkg] stop building snap from riseup_vpn 10 months ago
LICENSE [doc] add copyright notice 2 years ago
Makefile [docs] document the new package release process 4 months ago
README.md [i18n] Update locales, add german and a README notice about transifex 5 months ago
go.mod [pkg] update go.mod 4 months ago
go.sum [bug] switch to keybase go-ps implementation 4 months ago


Install it

Install dependencies:

  # make depends

Build the systray:

  $ git clone 0xacab.org/leap/bitmask-vpn && cd bitmask-vpn
  $ make build

You need at least go 1.11. If you have something older and are using ubuntu, you can do:

  make install_go

For other situations, have a look at https://github.com/golang/go/wiki/Ubuntu or https://golang.org/dl/


Using homebrew:

  $ git clone 0xacab.org/leap/bitmask-vpn && cd bitmask-vpn
  $ make depends
  $ make build


Building the systray in linux will produce some -Wdeprecated-declarations warnings, like that:

cgo-gcc-prolog: In function ‘_cgo_3f9f61f961c9_Cfunc_gtk_font_button_get_font_name’:
cgo-gcc-prolog:5455:2: warning: ‘gtk_font_button_get_font_name’ is deprecated [-Wdeprecated-declarations]
In file included from /usr/include/gtk-3.0/gtk/gtk.h:106:0,
                 from ../../../go/src/github.com/gotk3/gotk3/gtk/gtk.go:48:
/usr/include/gtk-3.0/gtk/gtkfontbutton.h:96:23: note: declared here
 const gchar *         gtk_font_button_get_font_name  (GtkFontButton *font_button);

They are expected and don’t produce any problem on the systray.

Run it

The default build is a standalone systray. It still requires a helper and openvpn installed to work. For linux the helper is bitmask-root for windows and OSX there is a helper written in go.

To build and run it:

  $ make build
  $ build/bin/bitmask-vpn


Is also posible to compile the systray to use bitmask as backend:

  $ go build -tags bitmaskd

In that case bitmask-systray assumes that you already have bitmaskd running. Run bitmask and the systray:

  $ bitmaskd
  $ build/bin/bitmask-vpn


The translations are done in transifex. To help us contribute your translations there and/or review the existing ones: https://www.transifex.com/otf/bitmask/RiseupVPN/

When a string has being modified you need to regenerate the locales:

  $ make generate_locales

To fetch the translations from transifex and rebuild the catalog.go (API_TOKEN is the transifex API token):

  $ API_TOKEN='xxxxxxxxxxx' make locales

There is some bug on gotext and the catalog.go generated doesn’t have a package, you will need to edit cmd/bitmask-vpn/catalog.go and to have a package main at the beginning of the file.

If you want to add a new language create the folder locales/$lang before running make locales.

Report an issue

When you report an issue include the following information:

  • what you expected to see
  • what you got
  • the version of the program. You can check the version on the about page.
  • the logs of the program. The location of the logs depends on the OS:
    • linux: /home/<your user>/.config/leap/bitmaskd.log & /home/<your user>/.config/leap/systray.log
    • OSX: /Users/<your user>/Library/Preferences/leap/systray.log, /Applications/RiseupVPN.app/Contents/helper/helper.log & /Applications/RiseupVPN.app/Contents/helper/openvpn.log
    • windows: C:\Users\<your user>\AppData\Local\leap\systray.log, C:\Program Files\RiseupVPN\helper.log & C:\Program Files\RiseupVPN\openvp.log