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
+33-12Lines changed: 33 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,25 +14,46 @@ A fast, privacy-first ad and tracker blocker for Chrome and Chromium browsers. B
14
14
15
15
## Installation
16
16
17
-
### Option 1 — Chrome Web Store*(coming soon)*
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
-
The extension will be submitted to the Chrome Web Store. Once approved, you can install it with one click — no developer tools or technical setup required.
19
+
### Step 1 — Download
20
20
21
-
### Option 2 — Load from a GitHub Release (recommended for now)
21
+
Go to [Releases](https://github.com/RainyRoot/AdBlocker/releases) and download the latest `adblocker-*.zip`.
22
22
23
-
No build tools needed. Download the pre-built extension and load it manually:
23
+
### Step 2 — Unzip
24
24
25
-
1. Go to [Releases](https://github.com/RainyRoot/AdBlocker/releases) and download the latest `adblocker-*.zip`
26
-
2. Unzip it to a permanent folder (don't delete it after loading)
27
-
3. Open `chrome://extensions` in your browser
28
-
4. Enable **Developer mode** (toggle in the top-right corner)
29
-
5. Click **Load unpacked** and select the unzipped folder
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.
30
26
31
-
The AdBlocker icon will appear in your toolbar. Works in Chrome, Brave, Edge, Arc, and any other Chromium-based browser.
27
+
### Step 3 — Load in Chrome
32
28
33
-
> **Note:** Chrome may show a warning that the extension is not from the Web Store. This is normal for manually loaded extensions — it does not mean the extension is unsafe.
29
+
1. Open `chrome://extensions` in Chrome
30
+
2. Enable **Developer mode** (toggle in the top-right corner)
31
+
3. Click **Load unpacked**
32
+
4. Select the folder you just unzipped
34
33
35
-
### Option 3 — Build from Source
34
+
The AdBlocker icon will appear in your toolbar. Done.
35
+
36
+
Works in Chrome, Brave, Edge, Arc, and any other Chromium-based browser.
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.
39
+
40
+
## Daily Use
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.
43
+
44
+
**Toolbar icon** — Click the AdBlocker icon in your toolbar to:
45
+
- See how many requests have been blocked on the current page
46
+
- Pause blocking for the current site (allowlist toggle)
47
+
- Re-enable blocking after pausing
48
+
49
+
**Options page** — Right-click the icon and choose **Options** (or go to `chrome://extensions`, find AdBlocker, and click **Details > Extension options**) to:
50
+
- Enable the optional uBlock Extended filter list for more aggressive blocking
51
+
- Add custom URL patterns to block
52
+
- Manage your per-site allowlist
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.
0 commit comments