ClearURLs is an add-on based on the new WebExtensions technology and will automatically remove tracking elements from URLs to help protect your privacy.
Go to file
2024-07-14 14:09:17 +00:00
_locales Merge branch 'translation' 2022-07-27 00:43:04 +02:00
.github Update FUNDING.yml 2020-08-22 00:26:59 +02:00
.gitlab Grammar 2020-11-27 22:41:35 +00:00
build_tools Added yandex link fixer + renewed copyright notice 2020-01-06 17:14:34 +01:00
core_js Merge remote-tracking branch 'temp2/patch-2' 2024-05-29 17:13:22 +02:00
css fix: table text color in dark mode 2022-07-10 22:06:31 +05:30
data@84aad05076 Update to newest version 2022-02-12 01:29:00 +01:00
external_js Replace deprecated String.prototype.substr() 2022-03-22 21:45:19 +01:00
fonts Version 1.1.2.5 2017-11-18 01:34:01 +01:00
html ETag filtering 2023-05-10 11:28:43 +02:00
img Version 1.21.0 2021-03-24 12:55:46 +01:00
.gitignore Removed rule 2019-09-13 12:58:28 +02:00
.gitlab-ci.yml Update .gitlab-ci.yml 2024-07-14 14:09:17 +00:00
.gitmodules Update submodule 2022-02-12 01:27:02 +01:00
browser-polyfill.js remove sourcemap ref from browser-polyfill.js 2019-07-05 12:16:29 +00:00
CHANGELOG.md ETag filtering 2023-05-10 11:28:43 +02:00
clearurls.js Fixed URLSearchParams spaces (x sign) bug 2023-11-11 15:54:08 +01:00
LICENSE Change of LICENSE to GNU LGPLv3. This change is granted by the old license (QaPL v0.2 sec. [4]) without the permission of the contributors. 2019-03-13 11:58:04 +00:00
manifest.json ETag filtering 2023-05-10 11:28:43 +02:00
PRIVACY.md Update PRIVACY.md 2021-01-07 22:02:22 +00:00
README.md Updated README.md 2023-01-31 22:39:53 +01:00

Buy Me A Coffee Buy Me A Coffee Buy Me A Coffee

for Firefox for Edge for Chrome

ClearURLs Gitter

ClearURLs is an add-on based on the new WebExtensions technology and is optimized for Firefox and Chrome based browsers.

This extension will automatically remove tracking elements from URLs to help protect your privacy when browsing the Internet, which is regularly updated by us and can be found here.

Application

Many websites use tracking elements in the URL (e.g. https://example.com?utm_source=newsletter1&utm_medium=email&utm_campaign=sale) to mark your online activity. All that tracking code is not necessary for a website to be displayed or work correctly and can therefore be removed—that is exactly what ClearURLs does.

Another common example are Amazon URLs. If you search for a product on Amazon you will see a very long URL, such as:

https://www.amazon.com/dp/exampleProduct/ref=sxin_0_pb?__mk_de_DE=ÅMÅŽÕÑ&keywords=tea&pd_rd_i=exampleProduct&pd_rd_r=8d39e4cd-1e4f-43db-b6e7-72e969a84aa5&pd_rd_w=1pcKM&pd_rd_wg=hYrNl&pf_rd_p=50bbfd25-5ef7-41a2-68d6-74d854b30e30&pf_rd_r=0GMWD0YYKA7XFGX55ADP&qid=1517757263&rnid=2914120011

Indeed most of the above URL is tracking code. Once ClearURLs has cleaned the address, it will look like this: https://www.amazon.com/dp/exampleProduct

Features

  • Removes tracking from URLs automatically in the background
  • Blocks some common ad domains (optional)
  • Has a built-in tool to clean up multiple URLs at once
  • Supports redirection to the destination, without tracking services as middleman
  • Adds an entry to the context menu so that links can be copied quickly and cleanly
  • Blocks hyperlink auditing, also known as ping tracking (see also this article)
  • Prevents ETag tracking
  • Prevents tracking injection over history API (see also: The replaceState() method)
  • Prevents Google from rewriting the search results (to include tracking elements)
  • Prevents Yandex from rewriting the search results (to include tracking elements)

Permissons

Reasoning for needed permissions can be found under here.

Screenshot

Interface (version 1.14.0)

CI/CD Artifacts Download (for Firefox- and Chrome-Dev only)

Here you can download the packed files for the Firefox- and Chrome-Dev:

Test

If you want to test whether ClearURLs works correctly on your system, you can go to this test page: https://test.clearurls.xyz/

Contribute

If you have any suggestions or complaints, please create an issue.

Note: If you have any suggestions or complaints regarding the rules, please create an issue in this repo or email us rules.support (at) clearurls.xyz (this mail will automatically create a new issue in this repo).

Translate ClearURLs

You want to help translating ClearURLs into many languages? Nice

You can choose between two options to contribute. You can create a merge request, or you can use the POEditor to translate ClearURLs.

Hint: The description field in the translation files are only an information for what the translation is used. It is not necessary to translate the description field; in the most cases it is empty.

Merge request

If you want to create a merge request, you must open the path _locales/en/messages.json in the ClearURLs repo and translate the english terms into terms of your language. Once you have translated all the terms, you make a pull request of your translation. Please push your translation into the folder _locales/{language code}/messages.json.

POEditor

https://poeditor.com/join/project/vKTpQWWvk2

Projects that use parts of ClearURLs

  • Uroute used ClearURLs to filter/clean URL before launching browser
  • Scrub used ClearURLs to filter/clean URLs as cog for the Red Discord bot
  • Unalix small, dependency-free, fast Python package for removing tracking fields from URLs
  • Unalix-nim small, dependency-free, fast Nim package and CLI tool for removing tracking fields from URLs
  • UnalixAndroid simple Android app that removes link masking/tracking and optionally resolves shortened links

Permissions

Reasoning for needed permissions you can find under this wiki page.

We use some third-party scripts in our add-on. The authors and licenses are listed below.