LEGACY Privacy Badger for Firefox SEE README
This version of privacy badger is no longer maintained. All of the source code for privacy badger for Firefox, Chrome, and Opera now lives in one repository at: https://github.com/EFForg/privacybadger
Issues opened on this repository will not be checked.
Privacy Badger is a Firefox add-on that blocks spying ads and invisible trackers as you browse. More info here.
jpmpackage using npm.
npm install -g jpm
jpm -b runto launch a clean Firefox profile with Privacy Badger installed. Run
jpm -b testto run tests.
jpm xpicreates a package (.xpi file) that you can install by loading into Firefox.
hooks/ Git hooks. You can use them by copying into `.git/hooks`. The pre-push hook runs tests and cancels the push if they fail.
release-utils/ | Files for making a self-hosted release of Privacy Badger and updates that are signed with an offline private key. Makefile | You probably don't need to worry about these unless you're a project maintainer.
package.json | data/ | lib/ | Most of the code that runs in the add-on. See SDK documentation for more info on the directory structure. test/ | defaults/ |
doc/ Changelog, style guide, how to make a signed release, other documentation TBD.
Before you submit a pull request please consult the CONTRIBUTING.md file.
This is a rough summary of Privacy Badger's internal logic for blocking trackers. At the moment, "tracker" == "third-party cookie from a site that tracks you on multiple first-party origins." I am in the process of adding support for other non-cookie tracker types (local storage, etags, cache hits, etc.).
Privacy Badger uses a (relatively-simple) heuristic algorithm for deciding whether a third-party is tracking you. When Privacy Badger sees a third-party request on a website, it checks:
In addition, Privacy Badger will block third-party cookies from a domain if any of its parent domains have been blocked or cookie-blocked.
Note that users can manually set domains to be unblocked (green), cookie-blocked (yellow), or red (blocked). These choices always override the heuristic blocker.
By default, Privacy Badger sends the Do Not Track header on all requests. It also clears the referer for all requests that are cookie-blocked.
The current maintainers of this project are Cooper Quintin (cjq at eff dot org) and Noah Swartz (noah at eff dot org). There is also a mailing list to discuss Privacy Badger development for both Firefox and Chrome.