Skip to content

con-schy1/Analytics_AdBlocker

Repository files navigation


Analytics and Ad Blocker
Analytics & AdBlocker

Protect your privacy while browsing the web.

Edge   Edge
Edge

Key FeaturesHow To InstallDownloadHelpful DocumentationExamplesRulesCreditsLicense

veed

Key Features

  • Protect your privacy while browsing online - block ads and analytics (trackers)
    • Instantly see what has been blocked
  • Lightweight
    • A lightweigth browser extension to ensure browsing speed is not affected.
  • Simple UI/UX that you don't need a degree to read
  • Pause / Resume Blocking
    • If you notice that Analytics & Ad Blocker is affecting the page you're on you can simply pause the blocking, and resume as soon as you've completed the action you were trying to attempt
  • Easy to see reports
    • See the ads and trackers blocked by each site
    • See the different requests blocked on each site
  • OpenSource!
  • No tracking on YOU! We don't use any analytics within the extension.
  • Email us with any feedback or any ads / trackers you notice we missed.
  • Works with Edge, Safari, and Chrome

How To Install

Install-Chrome

1) Download all files and *images* folder into a single Folder.
2) Exclude the following files from download:
  * .github
  * License
  * README.md
3) Go to: chrome://extensions/ in your chrome browser
4) Toggle ON: Developer Mode - in the top right
5) Select the Folder you just created
6) You're ready to go!

Helpful Documentation

Examples

Example 1

  1. If you find an Ad, look at it in the Browser's Dev tools.

It will look something like:

<script async="" src="https://www.adexample1.com/"></script>
  1. Open the rules.json

The resulting rule to block this script will look like:

,
    {
    "id": 3000,
    "priority": 1,
    "action": { "type": "block" },
    "condition": {"urlFilter": "adexample1.com/", 
    "resourceTypes": ["script"] }
  }
  1. Add this rule to the rules.json, and make sure you change the id to go in order as the rule before it.
  2. Open the performance.js.

Add the following to the end of the adList array:

, /adexample1.c/
  1. Congratulate yourself- that's it!

Example 2

  1. If you find an Ad, look at it in the Browser's Dev tools.

It will look something like:

<iframe async="" src="https://www.adexample2.com/"></script>
  1. Open the rules.json

The resulting rule to block this script will look like:

,
    {
    "id": 3000,
    "priority": 1,
    "action": { "type": "block" },
    "condition": {"urlFilter": "adexample2.com/", 
    "resourceTypes": ["sub_frame"] }
  }
  1. Add this rule to the rules.json, and make sure you change the id to go in order as the rule before it.
  2. Open the performance.js.

Add the following to the end of the adList array:

, /adexample2.c/

But, you notice the ad is still there?

  1. Look at the Network requests for: adexample2.com/, and you see that it is sending a request after the iframe is blocked.
  2. Identify how it is calling the addition request and see that it's sending a Ping request type
  3. Write an additional rule and follow all the steps above. It will look something like this:
    {
    "id": 3001,
    "priority": 1,
    "action": { "type": "block" },
    "condition": {"urlFilter": "adexample2.com/", 
    "resourceTypes": ["ping"] }
  }
  1. There is no need to ad an additional entry in adList array.
  2. That's it! Repeat the steps until the ad is gone.

Rules

There's a couple project rules:

1) No Blocking Cookie Consent Banners and their technologies
2) No Blocking Chat Bots
3) Don't use *main_frame* as a Resource Type in your rules

Download

Credits

This software uses the following open source packages:

Support

Buy Me a Coffee at ko-fi.com

Contact

Contact Me

You may also like...

  • Globemallow - Create more performant webpages for a sustainable future for the internet.

License

Apache-2.0 License


globemallow.io  ·  GitHub @con_schy1  ·  Mastodon @globemallow@infosec.exchange