Skip to content

Commit a3730e7

Browse files
committed
docs: expand installation and daily usage instructions
1 parent 7d8d077 commit a3730e7

1 file changed

Lines changed: 33 additions & 12 deletions

File tree

README.md

Lines changed: 33 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -14,25 +14,46 @@ A fast, privacy-first ad and tracker blocker for Chrome and Chromium browsers. B
1414

1515
## Installation
1616

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.
1818

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
2020

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`.
2222

23-
No build tools needed. Download the pre-built extension and load it manually:
23+
### Step 2 — Unzip
2424

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.
3026

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
3228

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
3433

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.
55+
56+
### Build from Source
3657

3758
```bash
3859
git clone https://github.com/RainyRoot/AdBlocker.git

0 commit comments

Comments
 (0)