diff --git a/docs/adguard-content-blocker/_category_.json b/docs/adguard-content-blocker/_category_.json index da409d5abb9..683ff5faa65 100644 --- a/docs/adguard-content-blocker/_category_.json +++ b/docs/adguard-content-blocker/_category_.json @@ -1,5 +1,5 @@ { - "position": 9, + "position": 10, "label": "AdGuard Content Blocker", "collapsible": true, "collapsed": true diff --git a/docs/adguard-for-linux/_category_.json b/docs/adguard-for-linux/_category_.json index 8b25f567969..3ff758b1440 100644 --- a/docs/adguard-for-linux/_category_.json +++ b/docs/adguard-for-linux/_category_.json @@ -1,5 +1,5 @@ { - "position": 10, + "position": 11, "label": "AdGuard for Linux", "collapsible": true, "collapsed": true diff --git a/docs/adguard-mini-for-mac/_category_.json b/docs/adguard-mini-for-mac/_category_.json new file mode 100644 index 00000000000..abb0b0ca742 --- /dev/null +++ b/docs/adguard-mini-for-mac/_category_.json @@ -0,0 +1,6 @@ +{ + "position": 9, + "label": "AdGuard Mini for Mac", + "collapsible": true, + "collapsed": true +} \ No newline at end of file diff --git a/docs/adguard-mini-for-mac/adguard-mini-for-mac.md b/docs/adguard-mini-for-mac/adguard-mini-for-mac.md new file mode 100644 index 00000000000..c483410fcea --- /dev/null +++ b/docs/adguard-mini-for-mac/adguard-mini-for-mac.md @@ -0,0 +1,28 @@ +--- +title: AdGuard Mini for Mac +sidebar_position: 1 +--- + +:::info + +This page is about AdGuard Mini for Mac, which safeguards only your Safari browser. To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +AdGuard Mini for Mac (formerly AdGuard for Safari) was designed to conform to Apple’s restrictions for ad blocking browser extensions. Although it can’t be compared to our desktop ad blocking apps, it’s free and can protect you from ads, trackers, phishing, and malicious websites. + +- [Features](/adguard-mini-for-mac/features/features.md) + + Main features and settings available in AdGuard Mini for Mac + +- [Installation](/adguard-mini-for-mac/installation.md) + + Installation, removal, and system requirements for AdGuard Mini for Mac + +- [Safari extensions](/adguard-mini-for-mac/extensions.md) + + Mechanisms that enable content blocking and add functionality to the Safari web browser + +- [Solving problems](/adguard-mini-for-mac/solving-problems/solving-problems.md) + + Known issues and possible solutions diff --git a/docs/adguard-mini-for-mac/extensions.md b/docs/adguard-mini-for-mac/extensions.md new file mode 100644 index 00000000000..cd7001e55f9 --- /dev/null +++ b/docs/adguard-mini-for-mac/extensions.md @@ -0,0 +1,76 @@ +--- +title: Safari extensions +sidebar_position: 3 +--- + +:::info + +This article is about AdGuard Mini for Mac, which safeguards only your Safari browser. To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## What Safari extensions are + +Safari extensions are small software programs that add functionality to the Safari web browser. They allow users to customize and enhance their browsing experience by adding features that are not natively built into the browser. AdGuard Mini for Mac uses extensions primarily to apply filtering rules on websites opened in Safari. + +## How it works + +To block ads, trackers, and annoyances on websites, AdGuard uses filtering rules. The rules from AdGuard’s and your custom filters are converted into ones comprehensible by Safari and are integrated into 6 Safari extensions: + +- AdGuard General +- AdGuard Privacy +- AdGuard Social +- AdGuard Security +- AdGuard Custom +- AdGuard Other + +Each content-blocking extension can include up to 150,000 active filtering rules. The number of rules within most filter groups does not surpass 150,000. However, if you activate too many language-specific or custom filters, you might exceed the limit. In such cases, random rules that are over the limit will be automatically disabled, which may lead to incorrect blocking. **We strongly recommend activating only the filters you need**. + +There is also one more extension responsible for other features: *AdGuard for Safari*, which adds the AdGuard icon next to the search bar in Safari and allows using advanced rules to block complex ads. + +![Safari extensions](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/check-extensions.png) + +More on each extension below. + +## Content-blocking extensions + +*AdGuard General* applies rules from filters that you can find in *Settings* → *Filters* → *Ad blocking* and *Language-specific*. This extension focuses on comprehensive ad blocking and includes filters for ads in specific languages. + +*AdGuard Privacy* applies rules from filters located in *Filters* → *Privacy*. It blocks tracking mechanisms and ensures that your browsing activity remains private. + +*AdGuard Social* applies rules from filters that can be found in *Filters* → *Social Widgets* and *Filters* → *Annoyances*. It blocks popups, social media buttons, online assistant windows, and other elements on webpages that you might find annoying. + +*AdGuard Security* applies rules from filters under *Filters* → *Security*. This extension identifies and blocks potentially harmful elements, safeguarding users from malicious content. + +*AdGuard Other* applies rules from filters that don’t fall under the above-mentioned categories and that are located in *Filters* → *Other*: *Filter unblocking search ads and self-promotion*, *AdGuard DNS filter*, and *AdGuard Experimental filter*. + +*AdGuard Custom* applies rules from filters that you add on your own to *Custom filters*. + +User rules and allowlist rules are included in every extension. + +## AdGuard for Safari + +*AdGuard for Safari* activates the AdGuard icon next to the search bar. It’s useful if you want to quickly set up protection for a specific website or block ads manually. + +*AdGuard for Safari* extension also contains advanced rules that aren’t converted to the format supported by Safari. These include [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [extended CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets), which allow AdGuard to block complex ads, such as those on YouTube. + +## How to manage Safari extensions + +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + +2. Click *Settings...* + +3. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +## Why AdGuard for Safari requires permission + +When enabling the *AdGuard for Safari* extension, you might notice that it requires **access to webpage content** and **access to browsing history**. Here’s why it needs these permissions: + +- Access to webpage content is required for manual ad blocking and advanced blocking rules to work correctly +- Access to browsing history is required to check the protection status on websites and determine which advanced rules should be applied + +We do not use this data for any other purpose or share it with anyone. For more info, you can consult our [Privacy policy](https://adguard.com/privacy.html). diff --git a/docs/adguard-mini-for-mac/features/_category_.json b/docs/adguard-mini-for-mac/features/_category_.json new file mode 100644 index 00000000000..b920ef141a3 --- /dev/null +++ b/docs/adguard-mini-for-mac/features/_category_.json @@ -0,0 +1,6 @@ +{ + "position": 2, + "label": "Features", + "collapsible": true, + "collapsed": true +} \ No newline at end of file diff --git a/docs/adguard-mini-for-mac/features/about.md b/docs/adguard-mini-for-mac/features/about.md new file mode 100644 index 00000000000..901b1760f63 --- /dev/null +++ b/docs/adguard-mini-for-mac/features/about.md @@ -0,0 +1,24 @@ +--- +title: About +sidebar_position: 7 +--- + +![About tab](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/about.png) + +On the *About* tab, you can check: + +- Current version of your AdGuard Mini app +- Current versions of the libraries + +You can also find the links to: + +- Our official website +- EULA and Privacy policy +- Acknowledgements +- Version history + +:::note Reminder + +AdGuard Mini for Mac can be downloaded for free [from the App Store](https://agrd.io/mini_mac). A detailed setup instruction is available in [this Knowledge Base article](/adguard-mini-for-mac/installation/). + +::: diff --git a/docs/adguard-mini-for-mac/features/advanced-blocking.md b/docs/adguard-mini-for-mac/features/advanced-blocking.md new file mode 100644 index 00000000000..e801ec4496f --- /dev/null +++ b/docs/adguard-mini-for-mac/features/advanced-blocking.md @@ -0,0 +1,16 @@ +--- +title: Advanced blocking +sidebar_position: 3 +--- + +![Advanced blocking](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/advanced-blocking.png) + +*Advanced blocking* is optional, but when enabled it unlocks stronger filtering: for example, it lets us apply extended rules to block tough cases such as some YouTube ads. You decide whether to grant Safari the extra permissions and whether you want that extra power. + +Here you can turn on the *AdGuard Extra* userscript — if there’s a website where ads just won’t go, like Facebook or YouTube. + +:::note + +*AdGuard Extra* is a feature of the [full version](/adguard-mini-for-mac/features/full-version.md). + +::: diff --git a/docs/adguard-mini-for-mac/features/features.md b/docs/adguard-mini-for-mac/features/features.md new file mode 100644 index 00000000000..04523e40724 --- /dev/null +++ b/docs/adguard-mini-for-mac/features/features.md @@ -0,0 +1,36 @@ +--- +title: Features +sidebar_position: 1 +--- + +- [Safari protection](/adguard-mini-for-mac/features/safari-protection.md) + + Core filtering feature with customizable options + +- [Advanced blocking](/adguard-mini-for-mac/features/advanced-blocking.md) + + Unlocks stronger filtering capabilities + +- [User rules](/adguard-mini-for-mac/features/rules.md) + + Custom filtering rules to fine-tune ad blocking + +- [Settings](/adguard-mini-for-mac/features/settings/settings.md) + + Various options that help you configure the app and filtering + +- [Support](/adguard-mini-for-mac/features/support.md) + + Helpful options for when you have a question or encountered a problem + +- [About](/adguard-mini-for-mac/features/about.md) + + Info about the app’s current version and a list of helpful links + +- [Safari toolbar menu](/adguard-mini-for-mac/features/toolbar-menu.md) + + A handy menu in the Safari toolbar + +- [Full version](/adguard-mini-for-mac/features/full-version.md) + + Advanced features that enhance filtering speed and power diff --git a/docs/adguard-mini-for-mac/features/full-version.md b/docs/adguard-mini-for-mac/features/full-version.md new file mode 100644 index 00000000000..4201b9d8a37 --- /dev/null +++ b/docs/adguard-mini-for-mac/features/full-version.md @@ -0,0 +1,20 @@ +--- +title: Full version +sidebar_position: 9 +--- + +AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. + +To activate it, you can use a regular AdGuard license, which is obtainable [on our website](https://adguard.com/license.html) or through in-app purchase. You can also use the 14-day trial to test the features beforehand. + +### AdGuard Extra + +AdGuard Extra is an advanced script that handles complex ads, mostly on social media and online video platforms. It also shuts down ad blocking circumvention technologies such as ad re-insertion. + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/advanced-blocking.png) + +### Real-time filter updates + +Receive filter updates as soon as there is a new rule or a fix. This ensures that your filters are always up-to-date and no ad slips through. + +![Real-time updates](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/real-time-updates.png) diff --git a/docs/adguard-mini-for-mac/features/rules.md b/docs/adguard-mini-for-mac/features/rules.md new file mode 100644 index 00000000000..b6ae06e45cb --- /dev/null +++ b/docs/adguard-mini-for-mac/features/rules.md @@ -0,0 +1,20 @@ +--- +title: User rules +sidebar_position: 4 +--- + +![User rules](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/user-rules.png) + +User rules can be used to customize ad blocking when you want something personal: exclude a website from filtering, unblock requests, or allow scripts on a certain webpage. They can be added manually, imported, or created automatically when you block an element on the page. + +To add your own filtering rules, use a [special syntax](/general/ad-filtering/create-own-filters). + +### Rule constructor + +We understand that writing filtering rules yourself is not every user’s cup of tea. That’s why you can just click *Create rule* to use a rule constructor: choose what you want to do, click through a few options, and you’re done. Block images, videos, scripts, or any other elements you’d rather not see on a page. + +![Rule constructor](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/build-a-rule.png) + +Here’s an example of a tricky case — a cookie popup that resists filtering. Find it in the page code, then open *User rules* and create a rule to block it: + + diff --git a/docs/adguard-mini-for-mac/features/safari-protection.md b/docs/adguard-mini-for-mac/features/safari-protection.md new file mode 100644 index 00000000000..42cfbc9c8af --- /dev/null +++ b/docs/adguard-mini-for-mac/features/safari-protection.md @@ -0,0 +1,22 @@ +--- +title: Safari protection +sidebar_position: 2 +--- + +:::info + +This article is about AdGuard Mini for Mac, which safeguards only your Safari browser. To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## Safari protection + +![General tab](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/safari-protection.png) + +*Safari protection* section is the most important area for the app’s core purpose. Settings are grouped logically and explained in plain language so you can quickly see what each option does. + +Here’s a simple explanation on what each group of settings does: + +![Protection screen part one *border](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/new/safari_protection_1.png) + +![Protection screen part two *border](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/new/safari_protection_2.png) diff --git a/docs/adguard-mini-for-mac/features/settings/_category_.json b/docs/adguard-mini-for-mac/features/settings/_category_.json new file mode 100644 index 00000000000..e72eccc98e5 --- /dev/null +++ b/docs/adguard-mini-for-mac/features/settings/_category_.json @@ -0,0 +1,6 @@ +{ + "position": 5, + "label": "Settings", + "collapsible": true, + "collapsed": true +} \ No newline at end of file diff --git a/docs/adguard-mini-for-mac/features/settings/filters.md b/docs/adguard-mini-for-mac/features/settings/filters.md new file mode 100644 index 00000000000..46f8af1da0f --- /dev/null +++ b/docs/adguard-mini-for-mac/features/settings/filters.md @@ -0,0 +1,24 @@ +--- +title: Filters +sidebar_position: 2 +--- + +![Filters tab](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/filters.png) + +In *Settings* → *Filters*, you can enable separate filters or whole categories of filters. + +Filters are the backbone of ad blocking and basically it’s what keeps the Internet clean. A filter is a list of rules written in a special syntax. Following these rules, content blockers can filter web traffic: block ads or requests to malicious websites. + +Filters are combined into eight thematic categories: *Ad Blocking, Privacy, Social widgets, Annoyances, Security, Language-specific filters, Custom,* and *Other filters*. + +Read more about [AdGuard filters](/general/ad-filtering/adguard-filters) or [ad filtering in general](/general/ad-filtering/how-ad-blocking-works). + +Changes in *Filters* are also reflected in *Settings* → *Safari extensions*. + +## Custom filters + +![Create custom filter](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/create-custom.png) + +To add a custom filter, go to *Settings* → *Filters* → *Custom filters* and enter a URL or a local file path in the relevant field. + +You can find a lot of filters at [filterlists.com](https://filterlists.com/). diff --git a/docs/adguard-mini-for-mac/features/settings/safari-extensions.md b/docs/adguard-mini-for-mac/features/settings/safari-extensions.md new file mode 100644 index 00000000000..e2e628abd91 --- /dev/null +++ b/docs/adguard-mini-for-mac/features/settings/safari-extensions.md @@ -0,0 +1,60 @@ +--- +title: Safari extensions +sidebar_position: 3 +--- + +![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/extensions.png) + +Safari extensions are mechanisms that allow implementing content blockers — thematic clusters of filters. For example, privacy-related filters are included in the content blocker with the corresponding name — *AdGuard Privacy*. + +Content blockers were designed for two reasons: to structure filters and to conform to Apple’s restrictions. + +[In 2019](https://adguard.com/en/blog/adguard-safari-1-5.html), Apple put limitations on ad blockers for Safari, allowing them to use only 50,000 filtering rules simultaneously. As this number was not enough for an ad blocker to provide a good filtering quality (*AdGuard Base Filter* alone has 30,000 filtering rules), we divided AdGuard for Safari into six content blockers each containing up to 50,000 rules. + +[In 2022](https://adguard.com/en/blog/adguard-for-safari-1-11.html), Apple increased the filtering rule limit for each content blocker to 150,000 rules applied simultaneously. Regarding AdGuard Mini for Mac, up to 900,000 rules can be enabled for all six content blockers. + +Whereas the limit has been increased, the structure of content blockers has remained the same. + +In *Safari extensions*, you can see which content blockers are enabled, how many rules each of them is using, and which filters are functioning. + +:::tip + +You can manage enabled filters in *Settings* → *Filters*. In *Safari extensions*, you can only see the list of enabled filters and the number of enabled rules. + +::: + +## List of AdGuard Mini’s Safari extensions + +### AdGuard General + +*AdGuard General* is a content blocker that combines the most essential filters for blocking ads. We recommend keeping *AdGuard Base Filter* always enabled. + +### AdGuard Privacy + +This content blocker is the main tool against counters and other web analytics tools. The *AdGuard Tracking Protection filter* is enabled by default. + +### AdGuard Social + +*AdGuard Social* contains filters against social media buttons, widgets, scripts, and icons. Other annoyance filters can also be found in this section: filters against popups, banners, cookie notices, and more. To enable them, find *Social Widgets* in *Settings* → *Filters*. + +### AdGuard Security + +This content blocker unites several security-related filters. *Malware Domains Blocklist* blocks domains that are notorious for spreading malware and spyware. *Spam404* protects you from Internet fraudsters. *NoCoin Filter List* disrupts browser-based cryptominers, such as Coinhive. + +### AdGuard Other + +*AdGuard Other* contains filters with various functions. For example, it has a filter that unblocks search ads and self-promo ads. In some cases, it helps find exactly what you are looking for, because these kinds of ads are more relevant and less intrusive than others. + +:::note Disclaimer + +We don’t have any “acceptable ads” paid by advertisers. Instead, we provide users with an option to see [search ads and websites’ self-promotion](/general/ad-filtering/search-ads). + +::: + +### AdGuard Custom + +![Create custom filter](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/create-custom.png) + +If you need more filters, you can add them to *AdGuard Custom* extension. + +To add a custom filter, go to *Settings* → *Filters* → *Custom filters* and enter a URL or a local file path in the relevant field. You can find new filters at [filterlists.com](https://filterlists.com/). diff --git a/docs/adguard-mini-for-mac/features/settings/settings.md b/docs/adguard-mini-for-mac/features/settings/settings.md new file mode 100644 index 00000000000..47d869898dd --- /dev/null +++ b/docs/adguard-mini-for-mac/features/settings/settings.md @@ -0,0 +1,20 @@ +--- +title: Settings +sidebar_position: 5 +--- + +![Settings tab](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/settings.png) + +In *Settings*, you can set up basic things like filters, filter updates, launching AdGuard at system startup, and so on. You can also choose whether to show the AdGuard icon in the menu bar. + +The main two sections are: + +- [Filters](/adguard-mini-for-mac/features/settings/filters.md) + + Different filters that allow you to customize your ad blocking experience + +- [Safari extensions](/adguard-mini-for-mac/features/settings/safari-extensions.md) + + Info on the current state of content blockers — how many rules and filters are enabled for each of them + +At the bottom of the *Settings* screen, you can find options that come in handy when communicating with our support team: *Debug logging* and *Export logs*. diff --git a/docs/adguard-mini-for-mac/features/support.md b/docs/adguard-mini-for-mac/features/support.md new file mode 100644 index 00000000000..5b939443adb --- /dev/null +++ b/docs/adguard-mini-for-mac/features/support.md @@ -0,0 +1,26 @@ +--- +title: Support +sidebar_position: 6 +--- + +![Support tab](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/support.png) + +*Support* section has helpful options in case you have a question or encounter a problem: + +- FAQ + + Answers to a lot of questions and problems can be found here + +- Report incorrect blocking + + Takes you to the page where you can report a bug or a problem in details + +- Contact support + + Contact our support team directly from the app, allowing you to attach logs and app info + + ![Contact support screen](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/contact-support.png) + +- Discuss + + Takes you to a page where you can find links to AdGuard’s social media and GitHub diff --git a/docs/adguard-mini-for-mac/features/toolbar-menu.md b/docs/adguard-mini-for-mac/features/toolbar-menu.md new file mode 100644 index 00000000000..bf290049d76 --- /dev/null +++ b/docs/adguard-mini-for-mac/features/toolbar-menu.md @@ -0,0 +1,36 @@ +--- +title: Safari toolbar menu +sidebar_position: 8 +--- + +![Safari toolbar assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/assistant.png) + +AdGuard Mini has a handy menu right in the Safari toolbar. To open it, click the icon located to the left of the search bar. + +Here’s what you can do in the toolbar menu: + +- **Pause icon** + + Disables AdGuard Mini + +- **Settings icon** + + Takes you to AdGuard Mini’s *Settings* screen + +- **Website info** + + Indicates the website you are currently on + +- **Protection** + + Turning it off disables filtering on the website you are currently on. Turning it back on resumes filtering on the website + +- **Block element** + + Lets you manually select and block any element on the page: select the element, adjust the selection frame (if needed), and click the *Block* button. To unblock an element, go to *Settings* → *User rules* and delete or uncheck the corresponding rule + + ![Manual blocking](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/manual-blocking.png) + +- **Report an issue** + + Takes you to a special form for reporting issues with some information automatically pre-filled diff --git a/docs/adguard-mini-for-mac/installation.md b/docs/adguard-mini-for-mac/installation.md new file mode 100644 index 00000000000..d96699765c4 --- /dev/null +++ b/docs/adguard-mini-for-mac/installation.md @@ -0,0 +1,70 @@ +--- +title: Installation +sidebar_position: 2 +--- + +:::info + +This article is about AdGuard Mini for Mac, which safeguards only your Safari browser. To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## System requirements + +Requires macOS 12 or later. + +## How to install AdGuard Mini for Mac + +AdGuard Mini for Mac is a free app present in the Mac App Store. To install it on your Mac, do the following: + +1. Open the App Store and find *AdGuard Mini* app there. + + ![AdGuard Mini in App Store](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/mini-in-app-store.png) + +2. Press *Get* → *Install* → *Open*. + +3. In the opened AdGuard Mini window, accept EULA and Privacy policy and click *Continue*. + + ![Onboarding](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/first-open.png) + +4. Click *Open settings*. + + ![Open settings](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/open-settings.png) + +5. Check the checkboxes for all seven AdGuard extensions. + + ![Checked extensions](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/check-extensions.png) + +6. To allow AdGuard Mini to work on all websites, click the *AdGuard for Safari* extension and then *Always Allow on Every Website...*. + + ![Always allow button](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/always-allow-button.png) + +7. In the notification that appears, click *Always Allow on Every Website...* again. + + ![Always allow notification](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/always-allow.png) + +After you complete these steps, AdGuard Mini for Mac will start functioning in Safari. + +## How to uninstall AdGuard Mini for Mac + +To uninstall AdGuard Mini for Mac, do the following: + +1. Quit the app. + +2. Click *Safari* in the left upper corner menu. + +3. Click *Settings…* → *Extensions*. You will see a list of extensions, AdGuard Mini has seven. + +4. Uncheck all checkboxes and press *Uninstall* below any of them. + + ![Unchecked extensions](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/unchecked-extensions.png) + +5. In the notification that appears, press *Show in Finder*. + + ![Uninstall notification](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/show-in-finder.png) + +6. Right-click *AdGuard Mini* and choose *Move to trash*. + + ![Move to trash](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/move-to-trash.png) + + AdGuard Mini for Mac will be removed from your device. diff --git a/docs/adguard-mini-for-mac/solving-problems/_category_.json b/docs/adguard-mini-for-mac/solving-problems/_category_.json new file mode 100644 index 00000000000..f4d013eef35 --- /dev/null +++ b/docs/adguard-mini-for-mac/solving-problems/_category_.json @@ -0,0 +1,6 @@ +{ + "position": 4, + "label": "Solving problems", + "collapsible": true, + "collapsed": true +} \ No newline at end of file diff --git a/docs/adguard-mini-for-mac/solving-problems/ads-not-blocked.md b/docs/adguard-mini-for-mac/solving-problems/ads-not-blocked.md new file mode 100644 index 00000000000..9cfea2a6402 --- /dev/null +++ b/docs/adguard-mini-for-mac/solving-problems/ads-not-blocked.md @@ -0,0 +1,30 @@ +--- +title: Filtering doesn’t work and ads aren’t blocked +sidebar_position: 2 +--- + +:::info + +This article is about AdGuard Mini for Mac, which safeguards only your Safari browser. To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +In some cases, filtering may not work and ads may still be displayed even though AdGuard Mini for Mac and the proper filters are enabled. This usually happens when something goes wrong with filter updates due to Safari bugs. + +### How to fix + +1. Open Safari. +2. Click *Safari* in the left upper corner menu. +3. Click *Settings…* → *Extensions*. +4. Clear the checkboxes for AdGuard Mini’s extensions: *Custom*, *General*, *Other*, *Privacy*, *Security*, *Social*, and *AdGuard for Safari*. + ![Unchecked extensions](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/unchecked-extensions.png) +5. Restart Safari. +6. Return to Safari → *Settings...* → *Extensions* and re-enable the AdGuard extensions. +7. Open AdGuard Mini’s menu. +8. Click *Check for updates*: + ![Update button *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/update-button.png) +9. Do not close the AdGuard Mini window until the filters are updated. + +If this doesn’t help and ads are still not being blocked, please contact our support at [support@adguard.com](mailto:support@adguard.com). + +If you only have problems with a specific page or website, you can report it directly from the browser: click the AdGuard Mini icon next to the Safari search bar and then click *Report an issue*. diff --git a/docs/adguard-mini-for-mac/solving-problems/filters-after-disable.md b/docs/adguard-mini-for-mac/solving-problems/filters-after-disable.md new file mode 100644 index 00000000000..c6522045d6e --- /dev/null +++ b/docs/adguard-mini-for-mac/solving-problems/filters-after-disable.md @@ -0,0 +1,24 @@ +--- +title: Filtering doesn’t stop when AdGuard Mini is disabled +sidebar_position: 3 +--- + +:::info + +This article is about AdGuard Mini for Mac, which safeguards only your Safari browser. To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +If filtering doesn’t stop when AdGuard Mini for Mac is disabled, it may be because content blockers take too long to update. + +## How to fix + +1. Open Safari. +2. Click *Safari* in the left upper corner menu. +3. Click *Settings…* → *Extensions*. +4. Clear the checkboxes for AdGuard Mini’s extensions: *Custom*, *General*, *Other*, *Privacy*, *Security*, *Social*, and *AdGuard for Safari*. + ![Unchecked extensions](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/unchecked-extensions.png) +5. Restart Safari. +6. Return to Safari → *Settings...* → *Extensions* and re-enable the AdGuard extensions. + +Now everything should work as intended: filtering is on when AdGuard Mini is enabled, and filtering is off when it is disabled. diff --git a/docs/adguard-mini-for-mac/solving-problems/logs.md b/docs/adguard-mini-for-mac/solving-problems/logs.md new file mode 100644 index 00000000000..76aaefbbedf --- /dev/null +++ b/docs/adguard-mini-for-mac/solving-problems/logs.md @@ -0,0 +1,32 @@ +--- +title: How to collect logs in AdGuard Mini for Mac +sidebar_position: 4 +--- + +:::info + +This article is about AdGuard Mini for Mac, which safeguards only your Safari browser. To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +To analyze and diagnose various problems that may occur with AdGuard Mini for Mac, the AdGuard support service may need its log files. These files contain records of errors and other software events. Below are brief instructions on how to collect logs and send them to support if necessary. + +### How to collect logs + +1. Open AdGuard Mini. +2. Go to *Settings*, scroll down, and click *Export logs*. +3. Choose a location to save the .zip file and click *Save*. + +Now you can send this file to [support@adguard.com](mailto:support@adguard.com) or attach it to your bug report on GitHub. + +:::note + +AdGuard is committed to protecting your privacy. We strictly follow our [Privacy Policy](https://adguard.com/privacy.html) and do not collect any private information about users. Before sending your logs to the support team, please review the file as it may contain additional information that you don’t want to share. If it contains such personal information, we recommend that you delete it first. + +::: + +### How to attach your log to a bug report on GitHub + +1. Go to the [AdGuard Mini for Mac GitHub repo](https://github.com/AdguardTeam/AdGuardMiniForMac/issues) and click *New issue*. +2. Send the log file to [devteam@adguard.com](mailto:devteam@adguard.com). Include the time of the bug and attach a link to your issue or its number (it appears as #number next to the title). + Alternatively, you can upload the log file to Google Drive and send it to [devteam@adguard.com](mailto:devteam@adguard.com). Add the file link to your GitHub issue. diff --git a/docs/adguard-mini-for-mac/solving-problems/private-sonoma.md b/docs/adguard-mini-for-mac/solving-problems/private-sonoma.md new file mode 100644 index 00000000000..c0584a533d7 --- /dev/null +++ b/docs/adguard-mini-for-mac/solving-problems/private-sonoma.md @@ -0,0 +1,22 @@ +--- +title: AdGuard Mini doesn’t work in private tabs on macOS Sonoma +sidebar_position: 5 +--- + +:::info + +This article is about AdGuard Mini for Mac, which safeguards only your Safari browser. To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## How to fix + +1. Open Safari. +2. Click *Safari* in the left upper corner menu. +3. Click *Settings…* → *Extensions*. +4. Check *Allow in Private Browsing* for all AdGuard extensions. + ![Checked private browsing](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adg-safari-sonoma-private.png) + +If this doesn’t help and ads are still not being blocked, please contact our support at support@adguard.com. + +If you only have problems with a specific page or website, you can report it directly from the browser: click the AdGuard Mini icon next to the Safari search bar, and then click *Report an issue*. diff --git a/docs/adguard-mini-for-mac/solving-problems/rule-limit.md b/docs/adguard-mini-for-mac/solving-problems/rule-limit.md new file mode 100644 index 00000000000..184d5bc932c --- /dev/null +++ b/docs/adguard-mini-for-mac/solving-problems/rule-limit.md @@ -0,0 +1,36 @@ +--- +title: Rule limit issues +sidebar_position: 1 +--- + +:::info + +This article is about AdGuard Mini for Mac, which safeguards only your Safari browser. To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## Safari content blocker rule limit + +AdGuard Mini for Mac uses the Content Blocking API to apply filtering rules to pages in the Safari browser. Currently, a maximum of 150,000 rules are allowed for each content-blocking extension. + +AdGuard Mini for Mac has 6 content blockers: + +- AdGuard General +- AdGuard Privacy +- AdGuard Social +- AdGuard Security +- AdGuard Other +- AdGuard Custom + +This makes a total of 900,000 filtering rules. + +However, **one extension can contain only up to 150,000 rules**. If you exceed this limit, some of the rules will not be applied. This may lead to incorrect blocking. + +## How to check if you are exceeding the rule limit + +1. Open AdGuard Mini app. +2. Go to *Settings* → *Safari extensions*. +3. Below each extension, you can see the enabled filters and the number of active rules. + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/extensions.png) + +If more than 150,000 rules are enabled in a content blocker, you may need to disable some filters or user rules from it. Go to *Filters*, select the problematic category, and disable the filters or user rules you don’t need. diff --git a/docs/adguard-mini-for-mac/solving-problems/solving-problems.md b/docs/adguard-mini-for-mac/solving-problems/solving-problems.md new file mode 100644 index 00000000000..42d6312918e --- /dev/null +++ b/docs/adguard-mini-for-mac/solving-problems/solving-problems.md @@ -0,0 +1,18 @@ +--- +title: Solving problems +sidebar_position: 1 +--- + +:::info + +This article is about AdGuard Mini for Mac, which safeguards only your Safari browser. To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +Here are some problems you may encounter and workarounds, as well as guides and instructions you may need: + +- [Rule limit issues](/adguard-mini-for-mac/solving-problems/rule-limit.md) +- [Filtering doesn’t work and ads aren’t blocked](/adguard-mini-for-mac/solving-problems/ads-not-blocked.md) +- [Filtering doesn’t stop when AdGuard Mini is disabled](/adguard-mini-for-mac/solving-problems/filters-after-disable.md) +- [How to collect logs in AdGuard Mini for Mac](/adguard-mini-for-mac/solving-problems/logs.md) +- [AdGuard Mini doesn’t work in private tabs on macOS Sonoma](/adguard-mini-for-mac/solving-problems/private-sonoma.md) diff --git a/docs/guides/_category_.json b/docs/guides/_category_.json index 338c5466d99..cae7ca0d22b 100644 --- a/docs/guides/_category_.json +++ b/docs/guides/_category_.json @@ -1,5 +1,5 @@ { - "position": 12, + "position": 13, "label": "Guides", "collapsible": true, "collapsed": true diff --git a/docs/miscellaneous/_category_.json b/docs/miscellaneous/_category_.json index e71860bef9e..8def401ad5e 100644 --- a/docs/miscellaneous/_category_.json +++ b/docs/miscellaneous/_category_.json @@ -1,5 +1,5 @@ { - "position": 11, + "position": 12, "label": "Miscellaneous", "collapsible": true, "collapsed": true