You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Kevin Röbert 468c2ac4ea Revert "Corrected line endings, so SRI hash are equals to the online versions" 16 hours ago
.gitlab Update Bug.md 3 weeks ago
GitLabPages Update i253.html 1 month ago
_locales Update messages.json (POEditor.com) 1 week ago
bin Version 1.3.4.0 bins 1 year ago
build_tools Version 1.9.2 4 days ago
core_js Version 1.9.2 4 days ago
css Chrome support 7 months ago
data b@spiegel.de 1 day ago
external_js Revert "Corrected line endings, so SRI hash are equals to the online versions" 16 hours ago
fonts Version 1.1.2.5 2 years ago
html Version 1.9.0 3 weeks ago
img Add png icons to support googles webextension api 7 months ago
promotion Updated promo pic 3 days ago
server Add license header 8 months ago
.gitignore Removed rule 2 months ago
.gitlab-ci.yml CI 4 days ago
CHANGELOG.md Version 1.9.2 4 days ago
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. 8 months ago
README.md Update README.md 3 weeks ago
browser-polyfill.js remove sourcemap ref from browser-polyfill.js 4 months ago
clearurls.js Version 1.9.2 4 days ago
manifest.json Version 1.9.2 4 days ago
package-lock.json Version 1.8.0 2 months ago
package.json Version 1.8.0 2 months ago

README.md

for Firefox for Chrome

ClearURLs

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

This add-on will remove the tracking fields from all URLs, which are visited by the browser, with the help of an external rule file, which is regularly updated by us and can be found here, to protect your privacy.

Application

Large (and small) websites use elements in the URL, e.g.: https://example.com?utm_source=newsletter1&utm_medium=email&utm_campaign=sale to track your online activities. In this example, the utm fields used to track a custom campaign, managed by Google. It tells the provider, and also Google, the source, the medium (e.g. email or web) and the specific campaign of the link. All these tracking fields are not necessary for a website to be displayed or work correctly and can therefore be removed - that is exactly what ClearURLs does, so you can think of it as an URL clean maid.

Another common example are Amazon URLs. If you search for a product on Amazon you will get a very long URL for this product, e.g.

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

, the most of this URL is available for tracking and is not needed. After ClearURLs has cleaned this URL, it looks like this: https://www.amazon.com/dp/exampleProduct

Screenshot

Interface (version 1.8.5)

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

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

Firefox

Chrome

Test

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

Contribute

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

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/{country code}/messages.json.

POEditor

Projects that use parts of ClearURLs

  • Uroute used ClearURLs to filter/clean URL before launching browser

Recommended by…

Permissions

Reasoning for needed permissions you can find under this discussion.

Copyright

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