You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+16-16Lines changed: 16 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,30 +1,30 @@
1
1
# AdBlocker
2
2
3
-
A fast, privacy-first ad and tracker blocker for Chrome and Chromium browsers. Built with [WXT](https://wxt.dev) and Manifest V3's `declarativeNetRequest` API — all blocking rules are compiled at build time, so there's no background page network sniffing and zero runtime overhead.
3
+
A fast, privacy-first ad and tracker blocker for Chrome and Chromium browsers. Built with [WXT](https://wxt.dev) and Manifest V3's `declarativeNetRequest` API all blocking rules are compiled at build time, so there's no background page network sniffing and zero runtime overhead.
4
4
5
5
## Features
6
6
7
-
-**EasyList + EasyPrivacy**— Industry-standard filter lists bundled at build time
8
-
-**uBlock Extended Filters**— Optional additional rules (opt-in from the options page)
9
-
-**Per-Domain Allowlist**— Pause blocking on specific sites with one click
10
-
-**Custom Rules**— Add your own URL patterns via the options page
11
-
-**Blocked Request Counter**— See how many ads and trackers have been stopped
12
-
-**Cosmetic Filtering**— Hides ad placeholders and empty frames via injected CSS
13
-
-**Zero Data Collection**— No telemetry, no analytics, no network requests from the extension itself
7
+
-**EasyList + EasyPrivacy**- Industry-standard filter lists bundled at build time
8
+
-**uBlock Extended Filters**- Optional additional rules (opt-in from the options page)
9
+
-**Per-Domain Allowlist**- Pause blocking on specific sites with one click
10
+
-**Custom Rules**- Add your own URL patterns via the options page
11
+
-**Blocked Request Counter**- See how many ads and trackers have been stopped
12
+
-**Cosmetic Filtering**- Hides ad placeholders and empty frames via injected CSS
13
+
-**Zero Data Collection**- No telemetry, no analytics, no network requests from the extension itself
14
14
15
15
## Installation
16
16
17
17
Since the extension is not yet on the Chrome Web Store, you load it manually. It takes about 2 minutes and works exactly the same as any store extension after that.
18
18
19
-
### Step 1 — Download
19
+
### Step 1 Download
20
20
21
21
Go to [Releases](https://github.com/RainyRoot/AdBlocker/releases) and download the latest `adblocker-*.zip`.
22
22
23
-
### Step 2 — Unzip
23
+
### Step 2 Unzip
24
24
25
-
Extract the zip to a **permanent folder**— somewhere you won't accidentally delete it (e.g. `Documents/AdBlocker`). Chrome loads the extension directly from that folder, so if you delete or move it, the extension breaks.
25
+
Extract the zip to a **permanent folder** somewhere you won't accidentally delete it (e.g. `Documents/AdBlocker`). Chrome loads the extension directly from that folder, so if you delete or move it, the extension breaks.
26
26
27
-
### Step 3 — Load in Chrome
27
+
### Step 3 Load in Chrome
28
28
29
29
1. Open `chrome://extensions` in Chrome
30
30
2. Enable **Developer mode** (toggle in the top-right corner)
@@ -35,13 +35,13 @@ The AdBlocker icon will appear in your toolbar. Done.
35
35
36
36
Works in Chrome, Brave, Edge, Arc, and any other Chromium-based browser.
37
37
38
-
> **"Disable developer mode extensions" popup**— Chrome may show this warning when it starts. Just click **Keep extensions** every time. This only appears because the extension wasn't installed from the store; it does not affect how the extension works.
38
+
> **"Disable developer mode extensions" popup** Chrome may show this warning when it starts. Just click **Keep extensions** every time. This only appears because the extension wasn't installed from the store; it does not affect how the extension works.
39
39
40
40
## Daily Use
41
41
42
-
Once loaded, AdBlocker runs automatically in the background — you don't need to do anything. Every request to an ad or tracker domain is blocked before it even loads.
42
+
Once loaded, AdBlocker runs automatically in the background you don't need to do anything. Every request to an ad or tracker domain is blocked before it even loads.
43
43
44
-
**Toolbar icon**— Click the AdBlocker icon in your toolbar to:
44
+
**Toolbar icon** Click the AdBlocker icon in your toolbar to:
45
45
- See how many requests have been blocked on the current page
46
46
- Pause blocking for the current site (allowlist toggle)
47
47
- Re-enable blocking after pausing
@@ -51,7 +51,7 @@ Once loaded, AdBlocker runs automatically in the background — you don't need t
51
51
- Add custom URL patterns to block
52
52
- Manage your per-site allowlist
53
53
54
-
**Blocking is silent**— There's no notification for every blocked ad. The counter in the popup shows the total. Pages just load faster and cleaner.
54
+
**Blocking is silent** There's no notification for every blocked ad. The counter in the popup shows the total. Pages just load faster and cleaner.
0 commit comments