Skip to content

Commit

Permalink
Merge pull request #405 from AdguardTeam/update-translations
Browse files Browse the repository at this point in the history
Update translations
  • Loading branch information
el-termikael authored Jan 22, 2024
2 parents 090a7a2 + ef76371 commit 0986f5a
Show file tree
Hide file tree
Showing 244 changed files with 4,145 additions and 1,325 deletions.
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
---
title: How to install AdGuard for Android TV
sidebar_position: 17
---

:::info

This article covers AdGuard for Android TV, an ad blocker that protects your TV at the system level. To see how it works, [download the AdGuard TV app](https://agrd.io/tvapk)

:::

In most cases, stock browsers cannot install a file on your TV, but you can download a browser from the Google Play Store that has this functionality. In our guide, we will consider an example of installation using the TV Bro browser, but there are other options and you can choose the one that better suits your needs. As an alternative, you can use the [Downloader](https://play.google.com/store/apps/details?id=com.esaba.downloader) app.

## Installing AdGuard for Android TV via browser

1. Install the [TV Bro browser](https://play.google.com/store/apps/details?id=com.phlox.tvwebbrowser) on your Android TV.

2. Download and install AdGuard for Android TV:

- Open the installed TV Bro browser on your Android TV.
- In the address bar of the browser, type `https://agrd.io/tvapk` and press _Enter_ or follow the link.
- The browser will start downloading the AdGuard for Android TV installation file automatically.
- Once the download is complete, select _Downloads_ in the browser control bar, then select the downloaded file.
- In a warning message, allow installing files from the browser.
- Return to your browser, open _Downloads_, and click the downloaded file.
- In the system window that appears, click _Install_, then _Done_ or _Open_.

Done, AdGuard for Android TV is installed.

1. Launch AdGuard for Android TV:

- After the installation is complete, find the AdGuard app in the list of installed apps on your Android TV.
- Click the AdGuard icon to launch the app.
- Follow the on-screen instructions to complete the setup.

## Installing AdGuard for Android TV via ADB

1. Make sure that Android Debug Bridge (ADB) is installed on your computer. If not, you can follow the instructions on XDA Developers: [ADB Installation Guide](https://www.xda-developers.com/install-adb-windows-macos-linux).

2. Download [AdGuard for Android TV](https://agrd.io/tvapk).

3. In your TV settings, go to _System__About_ and press the build number seven times to unlock developer options. Enable _USB debugging_.

4. Write down the IP address of your Android TV:

- On your Android TV, navigate to Settings.
- Select _System__About_.
- Find _Network_ and select _Wi-Fi_ or _Ethernet_, depending on your connection type.
- Go to the network section and find _IP address_. Note down this IP address.

5. Connect to Android TV via ADB:

- Open the terminal or command prompt on your computer.
- Enter the command `adb connect` and paste the IP address of your TV.
- The connection will be established.

6. Install AdGuard for Android TV via ADB:

- In the terminal, enter the command `adb install Downloads/adguard_tv.apk`. If necessary, replace `Downloads/adguard_tv.apk` with your path.
- Wait for a message in the terminal indicating the successful installation of the app.
Original file line number Diff line number Diff line change
Expand Up @@ -22,17 +22,21 @@ Follow these steps to install AdGuard certificate:
- The safety of this filtering process
- The necessity of AdGuard certificate

Consecutively tap *Next**Next**Save certificate* on these screens.
Consecutively tap *Next**Next**Save certificate*.

1. Tap *Save* at the bottom of the opened *Download* folder.

1. After saving, tap *Open Settings*, navigate to *Encryption & credentials*, and then choose *Install a certificate*.
1. After saving, tap *Open Settings*.

1. You might see a warning, if so, tap *Install anyway*. From the list, select the file with AdGuard certificate.
1. Tap *More security settings**Encryption & credentials**Install a certificate**CA certificate*.

1. You might see a warning. If so, tap *Install anyway* and enter your PIN if necessary.

1. Select the AdGuard certificate file. Its name should look like *adguard_1342_020322.crt*.

You're all set! Once the certificate is installed successfully, you've enabled HTTPS filtering.

Please note that the steps provided are based on the Google Pixel 4 smartphone. If you're using a different Android device, the exact menu names or options might vary. For easier navigation consider searching for a certificate by accessing your device's settings and entering "certificate" or "credentials" in the search bar.
Please note that the steps provided are based on the Google Pixel 7 smartphone. If you're using a different Android device, the exact menu names or options might vary. For easier navigation consider searching for a certificate by entering "certificate" or "credentials" in the settings search bar.

If you experience issues during the manual certificate installation (for example, you installed the certificate, but the application keeps ignoring it), you can follow one of the solutions below.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,10 @@ The new Browser Assistant has its own tab in the AdGuard for Mac settings, toget

## Legacy Assistant

Legacy Assistant is the previous version of Assistant, which is a mere userscript, not a browser extension. Basically, there are two cases when you might want to pick it instead of the new Browser Assistant: 1) the new Assistant is not available for your browser; 2) you are used to the green shield icon and want to leave things as they were. If you recognize yourself in any of these scenarios, then the legacy version will suit you.
Legacy Assistant is the previous version of Assistant, which is a mere userscript, not a browser extension. Basically, there are two cases when you might want to pick it instead of the new Browser Assistant:

1. The new Assistant is not available for your browser.
1. You are used to the green shield icon and want to leave things as they were.

## How to install AdGuard Browser Assistant

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ This article covers AdGuard for Mac, a multifunctional ad blocker that protects

## System requirements

**Operating system version:** macOS 10.13 (64 bit) or higher
**Operating system version:** macOS 10.15 (64 bit) or higher

**RAM:** at least 2 GB

Expand Down Expand Up @@ -81,15 +81,18 @@ Go to the Applications section. Find AdGuard there, right-click it and choose **
- /Library/Logs/com.adguard.mac.adguard/com.adguard.mac.adguard.adguard-tun-helper.daemon.log (file)

To do so, open the Terminal app, then enter and execute the following commands:
- `sudo rm -R "/Library/Application Support/AdGuard Software/com.adguard.mac.adguard"`
- `rm -R "$HOME/Library/Application Support/com.adguard.mac.adguard"`
- `rm $HOME/Library/Preferences/com.adguard.mac.adguard.plist`
- `rm -R "$HOME/Library/Group Containers/TC3Q7MAJXF.com.adguard.mac"`
- `find "$HOME/Library/Application Support" -name "com.adguard.browser_extension_host.nm.json" -delete`
- `sudo rm /Library/LaunchDaemons/com.adguard.mac.adguard.adguard-pac.daemon.plist`
- `sudo rm /Library/LaunchDaemons/com.adguard.mac.adguard.adguard-tun-helper.daemon.plist`
- `sudo rm /Library/Logs/com.adguard.mac.adguard/com.adguard.mac.adguard.adguard-pac.daemon.log`
- `sudo rm /Library/Logs/com.adguard.mac.adguard/com.adguard.mac.adguard.adguard-tun-helper.daemon.log`

```bash
sudo rm -R "/Library/Application Support/AdGuard Software/com.adguard.mac.adguard"
rm -R "$HOME/Library/Application Support/com.adguard.mac.adguard"
rm $HOME/Library/Preferences/com.adguard.mac.adguard.plist
rm -R "$HOME/Library/Group Containers/TC3Q7MAJXF.com.adguard.mac"
find "$HOME/Library/Application Support" -name "com.adguard.browser_extension_host.nm.json" -delete
sudo rm /Library/LaunchDaemons/com.adguard.mac.adguard.adguard-pac.daemon.plist
sudo rm /Library/LaunchDaemons/com.adguard.mac.adguard.adguard-tun-helper.daemon.plist
sudo rm /Library/Logs/com.adguard.mac.adguard/com.adguard.mac.adguard.adguard-pac.daemon.log
sudo rm /Library/Logs/com.adguard.mac.adguard/com.adguard.mac.adguard.adguard-tun-helper.daemon.log
```

1. Run the **Activity Monitor** app.
1. Using search tool, find the process **cfprefsd**.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,10 @@ The new Browser Assistant has its own tab in AdGuard for Windows settings, along

## Legacy Assistant

Legacy Assistant is the previous version of Assistant, which is a mere userscript, not a browser extension. Basically, there are two cases when you might want to pick it instead of the new Browser Assistant: 1) the new Assistant is not available for your browser; 2) you are used to the green shield icon and want to leave things as they were.
Legacy Assistant is the previous version of Assistant, which is a mere userscript, not a browser extension. Basically, there are two cases when you might want to pick it instead of the new Browser Assistant:

1. The new Assistant is not available for your browser.
1. You are used to the green shield icon and want to leave things as they were.

## How to install AdGuard Browser Assistant

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ For example:

- `https://example.org/banner/img`

### Basic rule modifiers
### Basic rule modifiers {#basic-rule-modifiers}

Filtering rules support numerous modifiers that allow you to fine-tune the rule behavior. Here is an example of a rule with some simple modifiers.

Expand Down
Original file line number Diff line number Diff line change
@@ -1,31 +1,52 @@
---
title: Userscripts
sidebar_position: 5
toc_max_heading_level: 4
---

Userscripts (we also call them "extensions") are, de-facto, mini-programs written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra.

### Supported apps
:::note Supported apps

AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/overview), [AdGuard for Android](/adguard-for-android/overview) and [AdGuard for Mac](/adguard-for-mac/overview).
AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/overview), [AdGuard for Android](/adguard-for-android/overview), and [AdGuard for Mac](/adguard-for-mac/overview).

### Recommended AdGuard scripts
:::

## Recommended AdGuard scripts

These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. Remember: whenever you download a userscript from an unknown source, you expose yourself to risk, as some scripts may be harmful to your computer. Get new scripts only from the sources you trust 100%. Furthermore, here are [some examples](#more-userscripts) of popular sites with scripts.

- **AdGuard Extra**. An extension that blocks advertising in difficult cases when the usual filter-based approach is not enough.
### AdGuard Extra

An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed with all premium AdGuard versions, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra).

![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png)

### AdGuard Popup Blocker

The name speaks for itself: it blocks pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it on [GitHub](https://github.com/AdguardTeam/PopupBlocker).

- **AdGuard Popup Blocker**. The name speaks for itself: it blocks pop-ups — one of the most annoying types of ads on web pages.
![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png)

- **AdGuard Assistant** (legacy version). This custom extension is designed to control filtering directly from the browser page (manual blocking, exclusion of the site, etc.).
### AdGuard Assistant (legacy version)

This custom extension is designed to control filtering directly from the browser page (manual blocking, exclusion of the site, etc.).

:::note

This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But legacy Assistant might be of help if there is no Browser Assistant extension for your browser.
This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant).

:::

- **Disable AMP**. A script, pre-installed only in AdGuard for Android, that disables AMP (Accelerated Mobile Pages) on the Google search results page.
### Disable AMP

A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP).

![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png)

### microShield

A userscript for people who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. Its original source code is available at [asdefuser](https://github.com/seia-soto/userscripts/tree/master/sources/asdefuser) and [AdShield Defuser](https://github.com/seia-soto/adshield-defuser). This userscript can be installed in AdGuard CoreLibs-based apps, Violentmonkey, Tampermonkey, and [quoid/userscripts](https://github.com/quoid/userscripts). Learn more about microShield and how to install it on [GitHub](https://github.com/List-KR/microShield).

## Where can you get more userscripts?{#more-userscripts}

Expand Down Expand Up @@ -55,9 +76,9 @@ If you like the idea of personifying your browser with the help of userscripts,

## Development

### Request License
### Request license

If you are developing your own custom script and want to test how it works with AdGuard, request a beta-license key for the app.
If you are developing your own custom script and want to test how it works with AdGuard, request a beta license key for the app.

To get it, please send an email to [email protected] with the following information:

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
---
title: How to install AdGuard for Android TV
sidebar_position: 17
---

:::info

This article covers AdGuard for Android TV, an ad blocker that protects your TV at the system level. To see how it works, [download the AdGuard TV app](https://agrd.io/tvapk)

:::

In most cases, stock browsers cannot install a file on your TV, but you can download a browser from the Google Play Store that has this functionality. In our guide, we will consider an example of installation using the TV Bro browser, but there are other options and you can choose the one that better suits your needs. As an alternative, you can use the [Downloader](https://play.google.com/store/apps/details?id=com.esaba.downloader) app.

## Installing AdGuard for Android TV via browser

1. Install the [TV Bro browser](https://play.google.com/store/apps/details?id=com.phlox.tvwebbrowser) on your Android TV.

2. Download and install AdGuard for Android TV:

- Open the installed TV Bro browser on your Android TV.
- In the address bar of the browser, type `https://agrd.io/tvapk` and press _Enter_ or follow the link.
- The browser will start downloading the AdGuard for Android TV installation file automatically.
- Once the download is complete, select _Downloads_ in the browser control bar, then select the downloaded file.
- In a warning message, allow installing files from the browser.
- Return to your browser, open _Downloads_, and click the downloaded file.
- In the system window that appears, click _Install_, then _Done_ or _Open_.

Done, AdGuard for Android TV is installed.

1. Launch AdGuard for Android TV:

- After the installation is complete, find the AdGuard app in the list of installed apps on your Android TV.
- Click the AdGuard icon to launch the app.
- Follow the on-screen instructions to complete the setup.

## Installing AdGuard for Android TV via ADB

1. Make sure that Android Debug Bridge (ADB) is installed on your computer. If not, you can follow the instructions on XDA Developers: [ADB Installation Guide](https://www.xda-developers.com/install-adb-windows-macos-linux).

2. Download [AdGuard for Android TV](https://agrd.io/tvapk).

3. In your TV settings, go to _System__About_ and press the build number seven times to unlock developer options. Enable _USB debugging_.

4. Write down the IP address of your Android TV:

- On your Android TV, navigate to Settings.
- Select _System__About_.
- Find _Network_ and select _Wi-Fi_ or _Ethernet_, depending on your connection type.
- Go to the network section and find _IP address_. Note down this IP address.

5. Connect to Android TV via ADB:

- Open the terminal or command prompt on your computer.
- Enter the command `adb connect` and paste the IP address of your TV.
- The connection will be established.

6. Install AdGuard for Android TV via ADB:

- In the terminal, enter the command `adb install Downloads/adguard_tv.apk`. If necessary, replace `Downloads/adguard_tv.apk` with your path.
- Wait for a message in the terminal indicating the successful installation of the app.
Original file line number Diff line number Diff line change
Expand Up @@ -22,17 +22,21 @@ Follow these steps to install AdGuard certificate:
- The safety of this filtering process
- The necessity of AdGuard certificate

Consecutively tap *Next**Next**Save certificate* on these screens.
Consecutively tap *Next**Next**Save certificate*.

1. Tap *Save* at the bottom of the opened *Download* folder.

1. After saving, tap *Open Settings*, navigate to *Encryption & credentials*, and then choose *Install a certificate*.
1. After saving, tap *Open Settings*.

1. You might see a warning, if so, tap *Install anyway*. From the list, select the file with AdGuard certificate.
1. Tap *More security settings**Encryption & credentials**Install a certificate**CA certificate*.

1. You might see a warning. If so, tap *Install anyway* and enter your PIN if necessary.

1. Select the AdGuard certificate file. Its name should look like *adguard_1342_020322.crt*.

You're all set! Once the certificate is installed successfully, you've enabled HTTPS filtering.

Please note that the steps provided are based on the Google Pixel 4 smartphone. If you're using a different Android device, the exact menu names or options might vary. For easier navigation consider searching for a certificate by accessing your device's settings and entering "certificate" or "credentials" in the search bar.
Please note that the steps provided are based on the Google Pixel 7 smartphone. If you're using a different Android device, the exact menu names or options might vary. For easier navigation consider searching for a certificate by entering "certificate" or "credentials" in the settings search bar.

If you experience issues during the manual certificate installation (for example, you installed the certificate, but the application keeps ignoring it), you can follow one of the solutions below.

Expand Down
Loading

0 comments on commit 0986f5a

Please sign in to comment.