Learn about tracking technologies, market structure and data-sharing on the web
Bringing Transparency to online tracking - built by Cliqz and Ghostery.
This repository contains:
* data on trackers and websites as shown on [whotracks.me](https://whotracks.me) (`./data`)
* database mapping tracker domains to companies (`./db`)
* code to render the [whotracks.me](https://whotracks.me) site
Python 3.x is needed to build the site. We recommend creating a
`pipenv`) to install the dependencies.
## From Pypi
$ pip install whotracksme
## From source
$ pip install -e .
That's all you need to get started!
# Using the data
To get started with the data, everything you need can be found in
from whotracksme.data import (
For more examples of scripts, have a look in the [contrib](./contrib) folder!
# Building the site
Building the site requires a few extra dependencies, not installed by default to
not make the installation heavier than it needs to be. You will need to install
`whotracksme` this way:
$ pip install 'whotracksme[website]'
Or if you do it from source:
$ pip install -e '.[website]'
*Furthermore* you also need to [install sass](http://sass-lang.com/install).
Once this is done, you will have access to a `whotracksme` entry point that can
be used this way:
$ whotracksme website [serve]
The `serve` part is optional and can be used while making changes on the
All generated artifacts can be found in the `_site/` folder.
To run tests, you will need `pytest`, or simply install `whotacksme` with the
$ pip install -e '.[test,website]'
We are happy to take contributions on:
* guest articles for our blog in the topics of tracking, privacy and security. Feel free to use the data in this repository if you need inspiration.
* Curating our database of tracker profiles.
The content of this project itself is licensed under the [Creative Commons Attribution 4.0 license](https://creativecommons.org/licenses/by/4.0/), and the underlying
source code used to generate and display that content is licensed under the [MIT license](https://github.com/cliqz-oss/whotracks.me/blob/master/LICENSE.md).
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.