Go to file
kkapsner 4a2079bf47 Add alpha version to updates.json during build 2024-02-17 00:07:11 +01:00
.documentation Added anchors to FAQ 2022-01-30 11:00:00 +01:00
.github Improve github issue template 2023-04-07 10:01:29 +02:00
.tools Add alpha version to updates.json during build 2024-02-17 00:07:11 +01:00
.vscode remove crowdin.yml from build 2023-05-30 19:04:40 +02:00
_locales New translations 2023-05-30 13:50:52 +02:00
browserAction Replace window.open with browser.tabs.create 2023-05-30 00:20:54 +02:00
icons Status Icon revision 2021-06-14 22:25:22 +02:00
lib Remove usage of deprecated browser.extension.getURL 2023-05-30 19:04:02 +02:00
options Increase bottom padding of options page 2023-05-30 13:42:30 +02:00
pageAction Replace window.open with browser.tabs.create 2023-05-30 00:20:54 +02:00
test Always protect about:blank 2023-04-19 14:34:37 +02:00
themes Fix export background color 2019-11-08 08:42:02 +01:00
versions Replace window.open with browser.tabs.create 2023-05-30 00:20:54 +02:00
.codebeatsettings Adjusted codebeat settings 2019-12-12 00:10:08 +01:00
.eslintignore Linting of .tools and test 2019-11-30 02:05:37 +01:00
.eslintrc.json Added testAPI and canvasAPI 2020-01-06 15:15:04 +01:00
.gitattributes 💥🐫 Added .gitattributes 2014-07-31 03:04:18 +02:00
.gitignore Initialized npm 2019-11-30 15:34:42 +01:00
LICENSE.txt Added MPL 2015-01-16 13:05:40 +01:00
README.md Update readme regarding built-in fingerprinting protection 2022-09-04 15:15:50 +02:00
crowdin.yml Fix crowdin.yml 2020-06-10 14:46:48 +02:00
manifest.json Version 1.10 2023-04-19 14:24:41 +02:00
package-lock.json Update package-lock.json 2024-02-16 23:48:34 +01:00
package.json Update web-ext to 7.6.1 2023-04-15 20:00:07 +02:00
releaseNotes.txt Increase bottom padding of options page 2023-05-30 13:42:30 +02:00

README.md

CanvasBlocker codebeat badge

This add-on allows users to prevent websites from using some Javascript APIs to fingerprint them. Users can choose to block the APIs entirely on some or all websites (which may break some websites) or just block or fake its fingerprinting-friendly readout API.

IMPORTANT: you should only have ONE addon/setting set that protects an API. Otherwise you could face massive performance issues. (E.g. EclipsedMoon for Palemoon has 'canvas.poison' which is known to cause issues: https://github.com/kkapsner/CanvasBlocker/issues/253#issuecomment-459499290) But setting privacy.resistFingerprinting to true and/or using the new fingerprinting protection introduced with Firefox 67 is fine.


Protected "fingerprinting" APIs:

  • canvas 2d
  • webGL
  • audio
  • history
  • window (disabled by default)
  • DOMRect
  • SVG
  • TextMetrics
  • navigator (disabled by default)
  • screen

More information on fingerprinting can be found at:


Beta versions can be found at https://canvasblocker.kkapsner.de/versions/.


The different block modes are:

  • fake: Canvas Blocker's default setting, and my favorite! All websites not on the white list or black list can use the protected APIs. But values obtained by the APIs are altered so that a consistent fingerprinting is not possible
  • ask for permission: If a website is not listed on the white list or black list, the user will be asked if the website should be allowed to use the protected APIs each time they are called.
  • block everything: Ignore all lists and block the protected APIs on all websites.
  • allow only white list: Only websites in the white list are allowed to use the protected APIs.
  • block only black list: Block the protected APIs only for websites on the black list.
  • allow everything: Ignore all lists and allow the protected APIs on all websites.

You can contribute to CanvasBlocker by translating it and/or improving the translations. For further instructions go to https://github.com/kkapsner/CanvasBlocker/issues/420.

Special thanks to:

  • spodermenpls for finding all the typos
  • Thorin-Oakenpants for the icon idea
  • anthologist and unbranched for the Italian translation
  • Maleficient for the French translation
  • yfdyh000 and KrasnayaPloshchad for the Chinese translation
  • micrococo for the Spanish translation
  • STim99 for the Russian translation

If you want to support this addon you can donate to the following addresses:

  • bitcoin: 159Y9BLcfHyrp6wj6f3syEuk92xkRVTiie
  • bitcoin cash:qrchnszkdwv9knhg9wjucrqy43rpl4klkq7jhkc8dz
  • monero: 482QYZaagALWtPmwbptwBaexDYmcVsJrhJp2VVjTgjYA3Kk1YyMdSg9Wz2qz1Gh31E843PFVCDWS4hR4Bjf6ipWuB9iz2cs