Skip to content

Update translations #667

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
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 @@ -39,7 +39,7 @@ The _Low-level settings_ section is for expert users. [Read more about low-level

This section allows you to manage HTTPS filtering settings, filters, and userscripts, and set up a proxy server.

![Filtering \*mobile_border](https://cdn.adtidy.org/blog/new/7v5c6filtering.png)
![Filtering \*mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/features/filtering.jpg)

### Filters

Expand All @@ -57,11 +57,19 @@ If you activate too many filters, some websites may work incorrectly.

[Read more about filters](https://adguard.com/en/blog/what-are-filters.html)

### Userscripts
### Extensions

Extensions allow you to add userscripts and userstyles.

![Extensions \*mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/features/extensions.jpg)

Userscripts are miniprograms written in JavaScript that extend the functionality of one or more websites. To install a userscripts, you need a special userscript manager. AdGuard has such a functionality and allows you to add userscripts by URL or from file.

![Userscripts \*mobile_border](https://cdn.adtidy.org/blog/new/isv6userscripts.png)
Userstyles are like userscripts that allow you to change how web pages look in the browser without modifying their content. They work by adding CSS styles to the website’s existing styles. For example, if you want a dark theme on a website that doesn’t offer one, you can use a userstyle to do it.

To add a userstyle, go to _Settings_ → _Filtering_ → _Extensions_→ _Add extension_ → _Import from file or URL_. You can find ready-made user styles [online](https://userstyles.world/).

To create your own style, tap _Add extension_ → _Create userstyle_.

#### AdGuard Extra

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: How to install AdGuard for Android TV
sidebar_position: 16
sidebar_position: 15
---

:::info
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: How to disable the Samsung Auto Blocker feature
sidebar_position: 19
sidebar_position: 18
---

:::info
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: How to protect AdGuard from being disabled by the system
sidebar_position: 9
sidebar_position: 8
---

:::info
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,12 @@ You can access it by navigating to *Statistics* → *Battery usage*.

Inside you will find a chart that shows the AdGuard battery resource consumption within the last 24 hours, with an option to get more detailed hour-to-hour data by tapping on the chart. Besides that, there’s also a numeric breakdown of the relevant data and a short technical explanation.

There are several other parameters below the chart: *CPU foreground*, *CPU background*, *Mobile data usage*, and *Wi-Fi data usage*.

*CPU foreground* and *CPU background* show how much CPU time is used by AdGuard when the app is active or running in the background.

And with *Mobile data usage* and *Wi-Fi data usage*, you can see how much traffic AdGuard consumed when your phone was using mobile Internet or connected to Wi-Fi.

### How much battery resource does AdGuard really consume?

First, let us lay down a bit of theory and links with necessary data.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Known compatibility issues with Android apps
sidebar_position: 15
sidebar_position: 14
---

:::info
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Problems caused by extending restricted settings
sidebar_position: 18
sidebar_position: 17
---

:::info
Expand All @@ -9,14 +9,16 @@ This article is about AdGuard for Android, a multifunctional ad blocker that pro

:::

In an effort to improve user privacy, Google has expanded the restriction settings in Android 15. More settings, such as _App usage access_, now require an additional permission to be enabled. Since the _[Firewall](/adguard-for-android/features/protection/firewall)_ and _[Detect Samsung Pay](/adguard-for-android/solving-problems/samsungpay-with-adguard-in-south-korea)_ features require the _App usage access_ setting to be enabled for them to work properly, you may have experienced problems using them. To resolve these issues, please follow the steps below:
In an effort to improve user privacy, Google has expanded the restriction settings in Android 15. More settings, such as _App usage access_, now require an additional permission to be enabled. Since the _[Firewall](/adguard-for-android/features/protection/firewall)_ and _[Detect Samsung Pay](/adguard-for-android/solving-problems/samsungpay-with-adguard-in-south-korea)_ features require the _App usage access_ setting to be enabled for them to work properly, you may have experienced problems using them. To resolve these issues, please follow the steps below.

:::note

AdGuard has a strict no-logging policy, which means that we do not collect your data or send it to third parties. We only ask for access to data without which the application cannot function.

:::

## Basic instructions

1. On your Android device, open the **Settings app**.
2. Tap **Apps**.
3. Tap **AdGuard**
Expand All @@ -34,3 +36,25 @@ Follow the on-screen instructions.
All done! Now the _Firewall_ and _Detect Samsung Pay_ features will work correctly.

![Restricted settings allowed for AdGuard \*mobile](https://cdn.adtidy.org/content/kb/ad_blocker/android/solving_problems/problems-caused-by-extending-restricted-settings/restricted3.png)

## For OneUI 7.0 users

For Samsung devices with OneUI 7.0, the app permission settings follow a different path. Follow these steps to configure app usage access:

1. Open _System settings_ → _Apps_

![Apps settings \*mobile](https://cdn.adtidy.org/content/kb/ad_blocker/android/solving_problems/problems-caused-by-extending-restricted-settings/apps.jpg)

1. Tap the menu icon (⋮) in the top-right corner, then select _Special access_

![Special access \*mobile](https://cdn.adtidy.org/content/kb/ad_blocker/android/solving_problems/problems-caused-by-extending-restricted-settings/three-dots.jpg)

1. Select _Usage data access_

![Special access menu \*mobile](https://cdn.adtidy.org/content/kb/ad_blocker/android/solving_problems/problems-caused-by-extending-restricted-settings/special.jpg)

1. Find and enable _AdGuard_

![Usage data access \*mobile](https://cdn.adtidy.org/content/kb/ad_blocker/android/solving_problems/problems-caused-by-extending-restricted-settings/usage_data.jpg)

All done!
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Manual installation of the security certificate into the Firefox browser
sidebar_position: 11
sidebar_position: 10
---

:::info
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Moving the CA certificate to the system store on rooted devices
sidebar_position: 14
sidebar_position: 13
---

:::info
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Certificate installation on devices with Android 11+
sidebar_position: 12
sidebar_position: 11
---

:::info
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Problems caused by multiple user profiles
sidebar_position: 10
sidebar_position: 9
---

:::info
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: How to set up outbound proxy
sidebar_position: 8
sidebar_position: 7
---

:::info
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: How to use Samsung Pay with AdGuard in South Korea
sidebar_position: 17
sidebar_position: 16
---

:::info
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Certificate installation in a Secure folder
sidebar_position: 13
sidebar_position: 12
---

:::info
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: How to block ads in the YouTube app
sidebar_position: 7
sidebar_position: 6
---

:::info
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,23 +5,25 @@ sidebar_position: 2

## Install AdGuard for Linux

To install AdGuard, enter:
Open the command line on your computer. On Linux, use the keyboard shortcut _Ctrl+Alt+T_. On Mac, type _Terminal_ in the search field.

Release
To install AdGuard, choose the version that better suits you (release, beta, or nightly) and enter the respective command.

```
**Release**:

```sh
curl -fsSL https://github.com/raw/AdguardTeam/AdGuardCLI/release/install.sh | sh -s -- -v
```

Beta
**Beta**:

```
```sh
curl -fsSL https://github.com/raw/AdguardTeam/AdGuardCLI/beta/install.sh | sh -s -- -v
```

Nightly
**Nightly**:

```
```sh
curl -fsSL https://github.com/raw/AdguardTeam/AdGuardCLI/nightly/install.sh | sh -s -- -v
```

Expand All @@ -35,57 +37,117 @@ You can verify the signature to prove it’s an official version of AdGuard by u

:::

## Activate license
## Initial setup

AdGuard for Linux requires an [AdGuard license](https://adguard.com/license.html). If you don't have a license yet, you can log in or create an account to get a free 14-day trial. If you already have a license, log in to activate it.
AdGuard for Linux requires an [AdGuard license](https://adguard.com/license.html). If you dont have a license yet, you can log in or create an account to get a free 14-day trial. If you already have a license, log in to activate it. To do it, follow this step-by-step guide:

To log in or create an account, enter:
1. After installation, enter:

```
adguard-cli activate
```
```sh
adguard-cli activate
```

To reset your license, enter:
2. Then select the desired option:

```
adguard-cli reset-license
```
![adguard-cli activate \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation1.png)

To view the license info, enter:
3. Once you have a license, follow the provided link to proceed with the activation:

```
adguard-cli license
```
![Activate license \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation2.png)

## Initial setup
4. After activation, you can continue to work with the program:

To get AdGuard up and running, complete the initial setup. This includes installing the AdGuard CA certificate, enabling the necessary filters, and selecting the proxy mode.
![Successful activation \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation3.png)

To run the configuration wizard, enter:
5. You can also reset your license by entering:

```
adguard-cli configure
```
```sh
adguard-cli reset-license
```

or view the license info by entering

```sh
adguard-cli license
```

6. Now you need to set up AdGuard CLI. To run the configuration wizard, enter:

```sh
adguard-cli configure
```

![Setup \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation4.png)

The wizard will ask basic questions required for the initial setup.

7. After that, you can start the AdGuard protection by entering

```sh
adguard-cli start
```

![Start protecton \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation5.png)

8. You can check the protection status using:

```sh
adguard-cli status
```

and stop it with:

```sh
adguard-cli stop
```

![Stop protecton \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation6.png)

9. To check the current configuration, enter:

```sh
adguard-cli config show
```

![Current setup \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation7.png)

The path to the configuration file will also be displayed, which you can and should edit directly. It contains descriptions of all additional options.

As an alternative, you can use the commands:

```sh
adguard-cli config get
```

or:

```sh
adguard-cli config set
```

They are primarily intended for scripting, though.

For further information on the available commands, check out the section [Settings and protection management](https://adguard.com/kb/adguard-for-linux/settings/).

## Uninstall AdGuard for Linux

To uninstall AdGuard, enter:

Release

```
```sh
curl -fsSL https://github.com/raw/AdguardTeam/AdGuardCLI/release/install.sh | sh -s -- -v -u
```

Beta

```
```sh
curl -fsSL https://github.com/raw/AdguardTeam/AdGuardCLI/beta/install.sh | sh -s -- -v -u
```

Nightly

```
```sh
curl -fsSL https://github.com/raw/AdguardTeam/AdGuardCLI/nightly/install.sh | sh -s -- -v -u
```

Expand Down
Loading