newhouse / url-tracking-stripper

An open-source Chrome Extension that will remove the tracking parameters from URLs to keep them short and cleaner for sharing, bookmarking, etc. It will also skip any known redirects and take you straight to the target URL instead of passing you through an intermediate URL.
MIT License
190 stars 26 forks source link

URL Tracking Stripper

A Chrome Extension designed with one intention: Increase the speed and privacy of your web browsing by skipping tracking redirects and removing the tracking parameters from URLs to keep them short and cleaner for sharing, bookmarking, etc.

User Installation

If you are just a normal end-user looking to use this extension, you can install this Extension in the Chrome Webstore

Chrome Webstore

Developer Instructions

If you are a developer and would like to fork, modify and/or contribute to this extesion, then this section is for you. Development of this extension requires that you have Node installed on your system. This is because it uses Gulp and Webpack to build the extension, minify it, and compress it for the Chrome Webstore. Here are instructions to get going:

  1. Clone this repository and cd into it.
  2. Install all dependencies via npm install
  3. During development, you can run gulp dev, which will build the extension without compressing it then will "watch" the input assets, triggering a rebuild automatically.
  4. When you're all done, to build an compressed and zipped version you can run just plain gulp.
  5. Add (or refresh) the local chrome (dev build) or chrome_uglified (production build) folder in the Chrome Extensions page.
  6. Be sure to see the Testing area below for testing requirements.

Testing

The test suite is just getting started, but I'm going to try and insist on tests (where appropriate) for all PRs. For sure, if you add a tracker you must add at least one test example to the trackerExamples array located in examples.js. The same is true for redirects: please add at least one test example to the redirectExamples array in examples.js.

To run the tests, simply execute: npm test

Documentation

The following URL parameters are removed:

Google's Urchin Tracking Module & Google Adwords

Adobe Analytics

Facebook

Instagram

Hubspot

Marketo

Mailchimp

SimpleReach

Vero

Unknown

Please file an Issue if you would like others tracked!

You can find the file with the trackers here.

Stripping Methods

This Extension is free and open source, and in no way is trying to keep tabs on you. However, different options provide different pros and cons around things like permissions, speed and privacy. Please read about the different "Stripping Methods" avaiable and choose which one is right for you:

1) History Change:

2) Block and Re-Load:

3) Block and Re-load + Skip Redirects:

Skip Known Redirects

Some links on pages (e.g. Google Search Results) look like they take you directly to the target URL, but really they will pass you through (an) intermediate server(s), cookie/track you, and then finally redirect you to the target URL. Some Stripping Methods make it possible for this extension to recognize when these links are clicked, and then extract the target URL and take you straight there, skipping the redirect and unnecessary tracking. For this reason, I recommend choosing the "Block and Re-load + Skip Redirects" Stripping Method.

You can find the file with the known redirects here.

Additional thoughts: This extension was not intended to be a catch-all for removing tracking and increasing your privacy. Its main purpose was simply to get a bunch of noise out of your address bar, with additional privacy (depending on your Stripping Method) being an added benefit. This extension also only monitors the URLs for the "main page" that you are visiting in your tabs, and does not monitor any resources that are subesquently loaded by that page that may contain tracking parameters. If you are really interested in privacy and actually blocking all tracking requests, I highly recommended you take a look at something that was designed with that as its goal, such as Ghostery [https://www.ghostery.com/].

Utilizes:

Thanks!

Thanks to the following:

Version History

Version history has been moved to the CHANGELOG. Please look at that for changes.