Cliqz Desktop Browser
Permalink
Failed to load latest commit information.
build-tools Switched to a new version of build-tools Jun 26, 2018
cliqz-helpers DB-921: add version for installer instead of default 7Zip version (4.42) Oct 18, 2016
l10n/de DB-1860: fixed translations for Homepage section Sep 17, 2018
mozilla-release Allow installation of AMO version of https-everywhere in DB Oct 17, 2018
.gitignore Changing location of api keys Jun 19, 2017
CHANGELOG.md DB-1762: update CHANGELOG with link to website Jul 5, 2018
Dockerfile apt-get update failing on a keyserver Aug 24, 2018
Jenkinsfile DB-1873: update signing process on CI Oct 10, 2018
Jenkinsfile.docker-images [WIP] Linux fixes and CI (#436) Nov 21, 2016
Jenkinsfile.lin DB-1873: update signing process on CI Oct 10, 2018
Jenkinsfile.mac DB-1873: update signing process on CI Oct 10, 2018
Jenkinsfile.release DB-1873: update signing process on CI Oct 10, 2018
Jenkinsfile.win DB-1873: update signing process on CI Oct 10, 2018
LICENSE Fixing repo url in the LICENSE (#853) Mar 12, 2018
README.md Update information about build in README Jan 9, 2018
build-helpers.groovy Increase git clone timeout time Nov 21, 2017
build_and_run_tests.sh Preparations for automated tests running (#291) May 13, 2016
build_win.bat DB-1873: update signing process on CI Oct 10, 2018
cliqz-dmg.json DB-1365: fix naming in MacOS dmg after signing. Jun 21, 2017
cliqz.cfg Fix | download failed message on AMO - prevent mozaddonmanager Oct 10, 2018
cliqz_env.sh DB-1838: temporary block Tor mode (commented out) Sep 11, 2018
download_windows_artifacts.sh DB-1721: use external tools as "artifacts" on Windows builder May 15, 2018
inject_tag_info.bat DB-1335, DB-1564: improve build scripts Dec 13, 2017
mac.Vagrantfile mac: update jenkins connection details Sep 6, 2018
magic_build_and_package.sh DB-1737: simplify "language repack" process Jun 5, 2018
magic_upload_files.sh DB-1873: update signing process on CI Oct 10, 2018
sign_lin.sh [WIP] Linux fixes and CI (#436) Nov 21, 2016
sign_mac.sh DB-1873: update signing process on CI Oct 10, 2018
sign_win.bat DB-1873: update signing process on CI Oct 10, 2018
win.Vagrantfile Different configuration of vmx in Vagrantfile and removal of lnk files" May 16, 2018

README.md

Cliqz Browser

Cliqz develops novel Internet browsers that incorporate proprietary features such as search and anti-tracking. This repository is about the Cliqz desktop browser, based on Mozilla Firefox – thus the repository name “browser-f” like Firefox. It is available for Windows and Mac. Learn more about our products and team at cliqz.com.

Most features developed by Cliqz and offered as part of the Cliqz browsers are maintained in the open source project browser-core.

If you are curious about our mobile browsers, please visit our open source projects for Cliqz for Android and Cliqz for iOS.

Building

First you should have an environment prepared to build regular Firefox. To do that follow Mozilla instructions.

Next run a building script: ./magic_build_and_package.sh

The successful build should create packages for the appropriate platform in:

  • windows installer: ./obj/dist/installer/sea/
  • mac dmg: ./obj/dist/
  • linux tar.bz2: ./obj/dist/

Details:

To build a Cliqz browser some environment variables must be set up. If they don't - build script will use deafult values for them. Also developer can specify them to have special build:

  • CQZ_BUILD_ID - special identifier which will be used as MOZ_BUILD_DATE on all platforms (for same buildid). It used to save build artifacts to separate location in repository.cliqz.com. Also this ID used to download a special version of Cliqz and https-everywhere extensions, which are necessary for proper build process.
  • CQZ_RELEASE_CHANNEL - which version to build, beta or release. By default building "beta" version.
  • CQZ_BUILD_DE_LOCALIZATION - by default will be only en-US localization build. If you need a DE version - set this flag to 1. By default not specified.
  • CQZ_BUILD_64BIT_WINDOWS - to build 64-bit version (for Windows only). On Mac always building 64-bit version. By default not specified.

Running

To test the build switch to build folder (./obj/dist/cliqz) and launch binaries.

Developing

There should be no differences in development from the regular Mozilla process.

Feature requests and bug reports

Please use github issues to submit bugs and requests.

When submitting the bug report please include the following information:

  • OS version, eg. Windox 8.1, Mac OS X 10.10.4
  • system architecture (32/64 bit)
  • browser version, eg. Cliqz 1.5.0, based on Firefox 47

Repository structure

For automated build purposes we keep copies of the original Mozilla project in our repository. Thus, the following folders are archives of respective Mozilla repositories:

Cliqz changes are applied to original Mozilla code.

Localization

Firefox localization files (production version) placed in https://hg.mozilla.org/releases/l10n/mozilla-release. Early for each released FF version it was possible to find appropriate tag in localization. Now looks like FF stop adding new tags for release in localization. In new reality, to find proper commit for some released FF version, please, do next:

Some more interesting FF's localization resources: