qwant-viprivacy

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

qwant-viprivacy

★ 32 Open GitHub ↗

Qwant VIPrivacy Extension

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

&nbsp;

<p align="center">
  <img src="https://user-images.githubusercontent.com/1442690/171180389-ad92ff55-0da7-4929-98b0-eff7a67e1765.png" width="300px" alt="Qwant VIPrivacy Browser Extension" />
</p>
<h3 align="center">Qwant VIPrivacy: protected browsing, enhanced privacy</h3>
<p align="center">
  In a world wide web where we are permanently tracked, the solution is Qwant VIPrivacy
  <br/>
  3 features that protect you during your browsing, in 1 single product
</p>

<p align="center">
    <a href="https://qwant.com/">Qwant.com</a> |
    <a href="https://twitter.com/Qwant_FR">Twitter</a> |
    <a href="https://t.me/ClubQwant">Telegram</a>
</p>

- [Installation](#installation)
  - [Chrome and Chromium-based browsers](#installation-chrome)
  - [Firefox](#installation-firefox)
  - [Microsoft Edge](#installation-edge)
- [Reporting issues](#contribution-reporting)
- [Development](#dev)
  - [Requirements](#dev-requirements)
  - [How to build](#dev-build)
  - [Linter](#dev-linter)
  - [Localizations](#dev-localizations)
- [Minimum supported browser versions](#minimum-supported-browser-versions)
- [Fork](#fork)
- [Privacy](#privacy)
- [Protection Level](#protection-level)
- [License](#license)

## Installation

### Chrome and Chromium-based browsers

You can get the latest available Qwant VIPrivacy Extension version from the [Chrome Web Store](https://chrome.google.com/webstore/detail/qwant/hnlkiofnhhoahaiimdicppgemmmomijo).

### Firefox

You can get the latest version of Qwant VIPrivacy Extension from the [Mozilla Add-ons website](https://addons.mozilla.org/fr/firefox/addon/qwantcom-for-firefox/).

### Microsoft Edge

The latest stable version of Qwant VIPrivacy browser extension is available in [Microsoft Store](https://microsoftedge.microsoft.com/addons/detail/qwant/eljplgljphmgjhnalbganhenlcapgnne).

## Reporting issues

GitHub can be used to report a bug or to submit a feature request. To do so, go to [this page](https://github.com/Qwant/qwant-viprivacy/issues) and click the _New issue_ button.

> **Note:** For filter-related issues (missed ads, false positives, broken pages etc.) open an issue in the [dedicated repository](https://github.com/AdguardTeam/AdguardFilters).

## Development

### Requirements

- [Node.js LTS](https://nodejs.org/en/download/)
- [Yarn v1.22](https://yarnpkg.com/en/docs/install/)

Install local dependencies by running:

```
yarn install
```

### How to build

**Building the dev version**

Run the following command:

```
yarn dev
```

```
yarn dev:watch
```

This will create a build directory with unpacked extensions for all browsers:

```
  build/dev/edge
  build/dev/chrome
  build/dev/firefox-amo
  build/dev/firefox-standalone
```

**Dev with Firefox**

- Start by running `yarn dev:watch:ff` in a separate terminal.
- In another terminal, execute `yarn start:firefox`.

**Building the beta and release versions**

Before building the release version, you should manually download necessary resources: filters and public suffix list.

```
yarn resources
```

You will need to put `mozilla_credentials.json` file in the `./private` directory. This build will create unpacked extensions and then pack them (xpi for Firefox).

**How to run tests**

```
yarn test
```

### Linter

Setup `eslint` in your editor to follow up with `.eslintrc`. Linting runs on every commit.

Or you can validate linting rules manually:

```
yarn lint
```

### Localizations

To validate translations run:

```
yarn locales:validate
```

To show locales info run:

```
yarn locales:info
```

## Minimum supported browser versions

| Browser                 | Version |
| ----------------------- | :-----: |
| Chromium Based Browsers |   79    |
| Firefox                 |   78    |
| Edge                    |   79    |

## History of the codebase

Qwant VIPrivacy is based on the excellent [Adguard Browser Extension](https://github.com/AdguardTeam/AdguardBrowserExtension). We chose to fork Adguard because it provides a solid basis for blocking trackers. We felt that it is a good starting point. It allows us to focus on providing a clean user-interface and curated defaults.

Thank you to Adguard for providing a fantastic foundation for this project.

## Privacy

Qwant VIPrivacy uses APM ([Application Performance Monitoring](https://www.elastic.co/guide/en/apm/guide/current/apm-overview.html)) to report bugs, catch errors and perform basic stats. Qwant VIPrivacy does not collect any PII (Personally Identifiable Information).

**TL;DR** This is the dashboard we use to observe general, anonymous trends and help keep an eye on the health of the extension.

<details><summary>Screenshot</summary>

![image](https://user-images.githubusercontent.com/1442690/168628853-57494bad-d90d-4969-af4d-468108eca1bb.png)

</details>

APM is optional and can be completely turned off during the onboarding or at any time. Enabling APM allows Qwant to resolve technical issues and bugs faster and provide a better user experience.

The basic information that goes through APM:

- Browser Type (Firefox, Chrome, Edge, etc...)
- Extension version (v1, v2, etc...)
- Basic stats (Do people prefer the "standard" or "strict" level of protection, etc..)
- Technical error reports (Did we make a mistake and how can we fix it)

## Protection level

Qwant VIPrivacy relies on a number of well-known and community-trusted lists.

These lists include rules used to detect and block trackers. Changing protection-levels essentially changes which lists are used.

We hand-picked the lists in `Standard Mode` to offer the best tracking protection with the least impact on the browsing experience. On the other hand, `Strict Mode` offers a more advanced tracking protection, however some pages may not display properly (social-media login, certain cookie banners, etc).

# Qwant Browser Android

Qwant VIPrivacy is available on [Qwant Android application](https://play.google.com/store/apps/details?id=com.qwant.liberty).

Since [QwantBrowserAndroid](https://github.com/Qwant/QwantBrowserAndroid) is based on the Firefox browser, we maintain a dedicated [production-android](https://github.com/Qwant/qwant-viprivacy/tree/production-android) branch for it.

## License

GNU General Public License v3.0

qwant-viprivacy

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README