Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
Original file line number Diff line number Diff line change
Expand Up @@ -302,3 +302,46 @@ adguard-cli import-settings -i "/path/to/settings.zip"
```

The `-i` or `--input` flag is required and specifies the path to the settings archive to import.

## AdGuard Browser Assistant

AdGuard Browser Assistant allows you to manage AdGuard protection directly from your browser.

![The Assistant window \*mobile](https://cdn.adtidy.org/content/kb/ad_blocker/mac/assistant_window.png)

### How it works

AdGuard Browser Assistant is a browser extension. It allows you to quickly manage AdGuard for Linux:

- Enable or disable protection for a specific website (the toggle under the website name)
- Pause protection for 30 seconds
- Disable protection (the pause icon in the upper right corner)
- Manually block an ad
- Report incorrect blocking
- Manage HTTPS filtering (the lock icon next to the website name)

### How to install

To install Native Messaging manifests for browser integration, use:

```sh
adguard-cli install-browser-integration
```

To uninstall the manifests, use:

```sh
adguard-cli install-browser-integration --uninstall
```

**Install AdGuard Browser Assistant extension**:

1. Open the [Assistant page](https://adguard.com/adguard-assistant/overview.html).
2. Under your browser name, select _Install_.
3. Install Assistant from your browser’s extension store.

:::info Compatibility

Support for AdGuard Browser Assistant is available starting from AdGuard for Linux v1.4.

:::
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,15 @@ This article describes AdGuard for Windows v8.0, a comprehensive ad blocker that

AdGuard for Windows is an easy-to-use tool that blocks annoying banners, popups, video ads, and trackers. But that’s not all: it helps you save traffic, load web pages faster, and protect your computer from undesirable and potentially malicious websites. AdGuard also protects you from phishing websites and keeps your kids away from inappropriate content.

## System requirements

- **OS version:** Microsoft Windows 10 or higher
- **RAM:** at least 6 GB
- **Processor:** 2-core, 2.0 GHz (or faster)
- **Free disk space:** at least 4 GB.

---

![Home screen](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/main_screen.png)

On the Home screen, you’ll find a toggle to enable or disable AdGuard protection, as well as icons for _Ad blocking_, _Tracking protection_, _DNS protection_, and _Annoyance blocking_. Main settings can be accessed through the left-side menu.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -107,13 +107,17 @@ This option should be enabled **only for debugging purposes**. Ticking the check

Adds extra space between the HTTP method and the URL and removes space after the "Host:" field to avoid deep packet inspection. For instance, the request

`GET /foo/bar/ HTTP/1.1
Host: example.org`
```text
GET /foo/bar/ HTTP/1.1
Host: example.org
```

will be converted to

`GET /foo/bar/ HTTP/1.1
Host:example.org`
```text
GET /foo/bar/ HTTP/1.1
Host:example.org
```

This option is only applied when the *Protect from DPI* Stealth mode option is enabled.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2671,8 +2671,7 @@ With these rules, specified UTM parameters will be removed from any request save
[AdGuard for Chrome MV3][ext-mv3] has some limitations:

- Regular expressions, negation and allowlist rules are not supported.
- Generic rules are applied before specific rules, and redirection occurs only once. This may prevent subsequent or more specific redirects from applying.
- Group of similar `$removeparam` rules will be combined into one. Example:
- Each `$removeparam` rule with a named parameter gets its own declarative rule with a param-aware `urlFilter` (e.g. `^utm_source=`). Chrome DNR applies a redirect only once per navigation, so without this, only the highest-priority rule would fire and the rest would be skipped. The param-aware `urlFilter` makes each rule fire only when its target parameter is present, forming a redirect chain — one parameter stripped per hop — until all are removed. Chrome allows up to 20 hops per navigation, which is enough for real-world tracking URLs. These hops are invisible to users. Example:

```bash
||testcases.adguard.com$xmlhttprequest,removeparam=p1case1
Expand All @@ -2693,20 +2692,59 @@ With these rules, specified UTM parameters will be removed from any request save
"transform": {
"queryTransform": {
"removeParams": [
"p1case1",
"p2case1",
"p1case1"
]
}
}
}
},
"condition": {
"urlFilter": "||testcases.adguard.com*^p1case1=",
"resourceTypes": [
"xmlhttprequest"
]
}
},
{
"id": 2,
"action": {
"type": "redirect",
"redirect": {
"transform": {
"queryTransform": {
"removeParams": [
"p2case1"
]
}
}
}
},
"condition": {
"urlFilter": "||testcases.adguard.com*^p2case1=",
"resourceTypes": [
"xmlhttprequest"
]
}
},
{
"id": 3,
"action": {
"type": "redirect",
"redirect": {
"transform": {
"queryTransform": {
"removeParams": [
"P3Case1"
]
}
}
}
},
"condition": {
"urlFilter": "||testcases.adguard.com",
"urlFilter": "||testcases.adguard.com*^P3Case1=",
"resourceTypes": [
"xmlhttprequest"
],
"isUrlFilterCaseSensitive": false
]
}
},
{
Expand All @@ -2724,10 +2762,10 @@ With these rules, specified UTM parameters will be removed from any request save
}
},
"condition": {
"urlFilter": "^p1case2=",
"resourceTypes": [
"xmlhttprequest"
],
"isUrlFilterCaseSensitive": false
]
}
}
]
Expand Down Expand Up @@ -4700,7 +4738,7 @@ Path-in-domain syntax works with all types of cosmetic rules (`##`, `#@#`, `#$#`

:::info Compatibility

Path-in-domain syntax has been introduced in [CoreLibs][] v1.20.
Path-in-domain syntax has been introduced in [CoreLibs][] v1.20, Browser extension v5.4.

:::

Expand Down Expand Up @@ -5026,9 +5064,9 @@ Used to specify the platforms to apply the rules. List of existing platforms and

- `cli` — AdGuard for Linux — [https://filters.adtidy.org/cli/filters/2.txt](https://filters.adtidy.org/cli/filters/2.txt)

- `android` — AdGuard for Android — [https://filters.adtidy.org/android/filters/2.txt](https://filters.adtidy.org/android/filters/2.txt)
- `android` — AdGuard for Android — [https://filters.adtidy.org/android/filters/2_optimized.txt](https://filters.adtidy.org/android/filters/2_optimized.txt)

- `ios` — AdGuard for iOS — [https://filters.adtidy.org/ios/filters/2.txt](https://filters.adtidy.org/ios/filters/2.txt)
- `ios` — AdGuard for iOS — [https://filters.adtidy.org/ios/filters/2_optimized.txt](https://filters.adtidy.org/ios/filters/2_optimized.txt)

- `ext_chromium` — AdGuard Browser Extension for Chrome — [https://filters.adtidy.org/extension/chromium/filters/2.txt](https://filters.adtidy.org/extension/chromium/filters/2.txt)

Expand All @@ -5040,9 +5078,9 @@ Used to specify the platforms to apply the rules. List of existing platforms and

- `ext_opera` — AdGuard Browser Extension for Opera — [https://filters.adtidy.org/extension/opera/filters/2.txt](https://filters.adtidy.org/extension/opera/filters/2.txt)

- `ext_safari` — AdGuard for Safari — [https://filters.adtidy.org/extension/safari/filters/2.txt](https://filters.adtidy.org/extension/safari/filters/2.txt)
- `ext_safari` — AdGuard for Safari — [https://filters.adtidy.org/extension/safari/filters/2_optimized.txt](https://filters.adtidy.org/extension/safari/filters/2_optimized.txt)

- `ext_android_cb` — AdGuard Content Blocker — [https://filters.adtidy.org/extension/android-content-blocker/filters/2.txt](https://filters.adtidy.org/extension/android-content-blocker/filters/2.txt)
- `ext_android_cb` — AdGuard Content Blocker — [https://filters.adtidy.org/extension/android-content-blocker/filters/2_optimized.txt](https://filters.adtidy.org/extension/android-content-blocker/filters/2_optimized.txt)

- `ext_ublock` — uBlock Origin — [https://filters.adtidy.org/extension/ublock/filters/2.txt](https://filters.adtidy.org/extension/ublock/filters/2.txt)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -302,3 +302,46 @@ adguard-cli import-settings -i "/path/to/settings.zip"
```

The `-i` or `--input` flag is required and specifies the path to the settings archive to import.

## AdGuard Browser Assistant

AdGuard Browser Assistant allows you to manage AdGuard protection directly from your browser.

![The Assistant window \*mobile](https://cdn.adtidy.org/content/kb/ad_blocker/mac/assistant_window.png)

### How it works

AdGuard Browser Assistant is a browser extension. It allows you to quickly manage AdGuard for Linux:

- Enable or disable protection for a specific website (the toggle under the website name)
- Pause protection for 30 seconds
- Disable protection (the pause icon in the upper right corner)
- Manually block an ad
- Report incorrect blocking
- Manage HTTPS filtering (the lock icon next to the website name)

### How to install

To install Native Messaging manifests for browser integration, use:

```sh
adguard-cli install-browser-integration
```

To uninstall the manifests, use:

```sh
adguard-cli install-browser-integration --uninstall
```

**Install AdGuard Browser Assistant extension**:

1. Open the [Assistant page](https://adguard.com/adguard-assistant/overview.html).
2. Under your browser name, select _Install_.
3. Install Assistant from your browser’s extension store.

:::info Compatibility

Support for AdGuard Browser Assistant is available starting from AdGuard for Linux v1.4.

:::
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,15 @@ This article describes AdGuard for Windows v8.0, a comprehensive ad blocker that

AdGuard for Windows is an easy-to-use tool that blocks annoying banners, popups, video ads, and trackers. But that’s not all: it helps you save traffic, load web pages faster, and protect your computer from undesirable and potentially malicious websites. AdGuard also protects you from phishing websites and keeps your kids away from inappropriate content.

## System requirements

- **OS version:** Microsoft Windows 10 or higher
- **RAM:** at least 6 GB
- **Processor:** 2-core, 2.0 GHz (or faster)
- **Free disk space:** at least 4 GB.

---

![Home screen](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/main_screen.png)

On the Home screen, you’ll find a toggle to enable or disable AdGuard protection, as well as icons for _Ad blocking_, _Tracking protection_, _DNS protection_, and _Annoyance blocking_. Main settings can be accessed through the left-side menu.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -107,13 +107,17 @@ This option should be enabled **only for debugging purposes**. Ticking the check

Adds extra space between the HTTP method and the URL and removes space after the "Host:" field to avoid deep packet inspection. For instance, the request

`GET /foo/bar/ HTTP/1.1
Host: example.org`
```text
GET /foo/bar/ HTTP/1.1
Host: example.org
```

will be converted to

`GET /foo/bar/ HTTP/1.1
Host:example.org`
```text
GET /foo/bar/ HTTP/1.1
Host:example.org
```

This option is only applied when the *Protect from DPI* Stealth mode option is enabled.

Expand Down
Loading
Loading