Black hole

Black hole ad-blocker is an invisible ad-blocker created for Chromium-based browser (Brave, Chrome...).

This project is currently under development, therefore it may not work as expected.

Table of content

• How it works
• Install the preview
• Making your blacklist
• Blocked sites

How it works 🛠️

When a request is made by the client it passes through the extension that redirects the sites in the blacklist to a non-existent one which, therefore, responds with an error, and the advertisement cannot load.

In this way, the sites fail to recognize this as an ad-blocker but simply as an internal error.

Install the preview 📁

Installing the preview is quite easy.

1. Download the source code and extract the folder
2. Go in background.js at line 3

  let url = chrome.runtime.getURL('data/blacklist_normal.json');

3. Edit blacklist_normal.json with your blacklist or keep this one
4. Go on your Chromium browser and open extensions settings as
   • brave://extensions/
   • chrome://extensions/
5. Enable developer mode
6. Click on Load Unpacked and select the folder (you probably have to reload the extension)
7. Now the extension is loaded.

Making your blacklist 📄

I created 2 file for you:

• Normal which blocks 43921 sites
• Aggressive which blocks 189416 sites

But you can make your own blacklist. It must be a json array like this:

[
  "*://*.site1.tld/*",
  ...
]

I suggest you this collection of blocklist.

I created a simple java app which you can use to create your own blocklist.
You only need to create a file like example.txt and then running these commands:

  cd helper
  javac helper.java
  java helper example.txt

The output will be like output.json.

Blocked sites ⛔

List of sites loaded:

• Normal
  • KAD host updated on 13/07/2021
  • Hosts updated on 13/07/2021
  • Easy privacy updated on 13/07/2021
  • Anti Malware host updated on 13/07/2021
• Aggressive
  • KAD host updated on 13/07/2021
  • Hosts updated on 13/07/2021
  • Easy privacy updated on 13/07/2021
  • Anti Malware host updated on 13/07/2021
  • add.Spam Host updated on 13/07/2021
  • AdGuard updated on 13/07/2021
  • Admiral updated on 13/07/2021
  • AdServers updated on 13/07/2021
  • Prigent Ads updated on 13/07/2021
  • add.2o7Net Host updated on 13/07/2021
  • Latest domain updated on 13/07/2021
  • Prigent Crypto updated on 13/07/2021
  • Host browser updated on 13/07/2021