Skip to content
Merged
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
  •  
  •  
  •  
76 changes: 74 additions & 2 deletions i18n/be/code.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
},
"theme.ErrorPageContent.tryAgain": {
"message": "Try again",
"description": "The label of the button to try again when the page crashed"
"description": "The label of the button to try again rendering when the React error boundary captures an error"
},
"theme.NotFound.title": {
"message": "Page Not Found",
Expand Down Expand Up @@ -93,7 +93,7 @@
},
"theme.colorToggle.ariaLabel": {
"message": "Switch between dark and light mode (currently {mode})",
"description": "The ARIA label for the navbar color mode toggle"
"description": "The ARIA label for the color mode toggle"
},
"theme.colorToggle.ariaLabel.mode.dark": {
"message": "dark mode",
Expand Down Expand Up @@ -412,5 +412,77 @@
"theme.tags.tagsPageTitle": {
"message": "Tags",
"description": "The title of the tag list page"
},
"theme.colorToggle.ariaLabel.mode.system": {
"message": "system mode",
"description": "The name for the system color mode"
},
"theme.admonition.warning": {
"message": "warning",
"description": "The default label used for the Warning admonition (:::warning)"
},
"theme.DocSidebarItem.expandCategoryAriaLabel": {
"message": "Expand sidebar category '{label}'",
"description": "The ARIA label to expand the sidebar category"
},
"theme.DocSidebarItem.collapseCategoryAriaLabel": {
"message": "Collapse sidebar category '{label}'",
"description": "The ARIA label to collapse the sidebar category"
},
"theme.IconExternalLink.ariaLabel": {
"message": "(opens in new tab)",
"description": "The ARIA label for the external link icon"
},
"theme.NavBar.navAriaLabel": {
"message": "Main",
"description": "The ARIA label for the main navigation"
},
"theme.docs.sidebar.navAriaLabel": {
"message": "Docs sidebar",
"description": "The ARIA label for the sidebar navigation"
},
"theme.navbar.mobileDropdown.collapseButton.expandAriaLabel": {
"message": "Expand the dropdown",
"description": "The ARIA label of the button to expand the mobile dropdown navbar item"
},
"theme.navbar.mobileDropdown.collapseButton.collapseAriaLabel": {
"message": "Collapse the dropdown",
"description": "The ARIA label of the button to collapse the mobile dropdown navbar item"
},
"theme.blog.author.pageTitle": {
"message": "{authorName} - {nPosts}",
"description": "The title of the page for a blog author"
},
"theme.blog.authorsList.pageTitle": {
"message": "Authors",
"description": "The title of the authors page"
},
"theme.blog.authorsList.viewAll": {
"message": "View all authors",
"description": "The label of the link targeting the blog authors page"
},
"theme.blog.author.noPosts": {
"message": "This author has not written any posts yet.",
"description": "The text for authors with 0 blog post"
},
"theme.contentVisibility.unlistedBanner.title": {
"message": "Unlisted page",
"description": "The unlisted content banner title"
},
"theme.contentVisibility.unlistedBanner.message": {
"message": "This page is unlisted. Search engines will not index it, and only users having a direct link can access it.",
"description": "The unlisted content banner message"
},
"theme.contentVisibility.draftBanner.title": {
"message": "Draft page",
"description": "The draft content banner title"
},
"theme.contentVisibility.draftBanner.message": {
"message": "This page is a draft. It will only be visible in dev and be excluded from the production build.",
"description": "The draft content banner message"
},
"theme.docs.DocCard.categoryDescription.plurals": {
"message": "1 item|{count} items",
"description": "The default description for a category card in the generated index about how many items this category includes"
}
}
122 changes: 99 additions & 23 deletions i18n/be/docusaurus-plugin-content-docs/current.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,79 +5,79 @@
},
"sidebar.tutorialSidebar.category.General": {
"message": "General",
"description": "The label for category General in sidebar tutorialSidebar"
"description": "The label for category 'General' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.Ad filtering": {
"message": "Ad filtering",
"description": "The label for category Ad filtering in sidebar tutorialSidebar"
"description": "The label for category 'Ad filtering' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.HTTPS filtering": {
"message": "HTTPS filtering",
"description": "The label for category HTTPS filtering in sidebar tutorialSidebar"
"description": "The label for category 'HTTPS filtering' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.AdGuard account": {
"message": "AdGuard account",
"description": "The label for category AdGuard account in sidebar tutorialSidebar"
"description": "The label for category 'AdGuard account' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.License": {
"message": "License",
"description": "The label for category License in sidebar tutorialSidebar"
"description": "The label for category 'License' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.AdGuard for Windows": {
"message": "AdGuard for Windows",
"description": "The label for category AdGuard for Windows in sidebar tutorialSidebar"
"description": "The label for category 'AdGuard for Windows' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.AdGuard for Mac": {
"message": "AdGuard for Mac",
"description": "The label for category AdGuard for Mac in sidebar tutorialSidebar"
"description": "The label for category 'AdGuard for Mac' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.Solving problems": {
"message": "Solving problems",
"description": "The label for category Solving problems in sidebar tutorialSidebar"
},
"sidebar.tutorialSidebar.category.AdGuard for Android": {
"message": "AdGuard for Android",
"description": "The label for category AdGuard for Android in sidebar tutorialSidebar"
"description": "The label for category 'AdGuard for Android' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.AdGuard for iOS": {
"message": "AdGuard for iOS",
"description": "The label for category AdGuard for iOS in sidebar tutorialSidebar"
"description": "The label for category 'AdGuard for iOS' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.AdGuard Browser extension": {
"message": "AdGuard Browser extension",
"description": "The label for category AdGuard Browser extension in sidebar tutorialSidebar"
},
"sidebar.tutorialSidebar.category.AdGuard for Safari": {
"message": "AdGuard for Safari",
"description": "The label for category AdGuard for Safari in sidebar tutorialSidebar"
"description": "The label for category 'AdGuard for Safari' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.AdGuard Content Blocker": {
"message": "AdGuard Content Blocker",
"description": "The label for category AdGuard Content Blocker in sidebar tutorialSidebar"
"description": "The label for category 'AdGuard Content Blocker' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.Miscellaneous": {
"message": "Miscellaneous",
"description": "The label for category Miscellaneous in sidebar tutorialSidebar"
"description": "The label for category 'Miscellaneous' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.Contribute to AdGuard": {
"message": "Contribute to AdGuard",
"description": "The label for category Contribute to AdGuard in sidebar tutorialSidebar"
"description": "The label for category 'Contribute to AdGuard' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.Translating AdGuard": {
"message": "Translating AdGuard",
"description": "The label for category Translating AdGuard in sidebar tutorialSidebar"
"description": "The label for category 'Translating AdGuard' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.Guides": {
"message": "Guides",
"description": "The label for category Guides in sidebar tutorialSidebar"
"description": "The label for category 'Guides' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.Technical support": {
"message": "Technical support",
"description": "The label for category Technical support in sidebar tutorialSidebar"
},
"sidebar.tutorialSidebar.category.AdGuard Browser Extension": {
"message": "AdGuard Browser Extension",
"description": "The label for category AdGuard Browser Extension in sidebar tutorialSidebar"
"description": "The label for category 'AdGuard Browser Extension' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.Features overview": {
"message": "Features overview",
Expand All @@ -89,38 +89,114 @@
},
"sidebar.tutorialSidebar.category.Content Blockers": {
"message": "Content Blockers",
"description": "The label for category Content Blockers in sidebar tutorialSidebar"
"description": "The label for category 'Content Blockers' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.Protection": {
"message": "Protection",
"description": "The label for category Protection in sidebar tutorialSidebar"
},
"sidebar.tutorialSidebar.category.Firewall": {
"message": "Firewall",
"description": "The label for category Firewall in sidebar tutorialSidebar"
"description": "The label for category 'Firewall' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.AdGuard for Linux": {
"message": "AdGuard for Linux",
"description": "The label for category AdGuard for Linux in sidebar tutorialSidebar"
"description": "The label for category 'AdGuard for Linux' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.AdGuard for Windows v8": {
"message": "AdGuard for Windows v8",
"description": "The label for category AdGuard for Windows v8 in sidebar tutorialSidebar"
"description": "The label for category 'AdGuard for Windows v8' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.Settings": {
"message": "Settings",
"description": "The label for category Settings in sidebar tutorialSidebar"
},
"sidebar.tutorialSidebar.category.App settings": {
"message": "App settings",
"description": "The label for category App settings in sidebar tutorialSidebar"
"description": "The label for category 'App settings' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.AdGuard Mini for Mac": {
"message": "AdGuard Mini for Mac",
"description": "The label for category AdGuard Mini for Mac in sidebar tutorialSidebar"
"description": "The label for category 'AdGuard Mini for Mac' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.solving-problems": {
"message": "solving-problems",
"description": "The label for category solving-problems in sidebar tutorialSidebar"
"description": "The label for category 'solving-problems' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.features-adguard-for-windows": {
"message": "Features",
"description": "The label for category 'Features' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.solving-problems-adguard-for-windows": {
"message": "Solving problems",
"description": "The label for category 'Solving problems' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.protection-adguard-for-windows-8": {
"message": "Protection",
"description": "The label for category 'Protection' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.settings-adguard-for-windows-8": {
"message": "Settings",
"description": "The label for category 'Settings' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.solving-problems-adguard-for-windows-8": {
"message": "Solving problems",
"description": "The label for category 'Solving problems' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.features-adguard-for-mac": {
"message": "Features",
"description": "The label for category 'Features' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.solving-problems-adguard-for-mac": {
"message": "Solving problems",
"description": "The label for category 'Solving problems' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.features-adguard-for-android": {
"message": "Features",
"description": "The label for category 'Features' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.protection-adguard-for-android-features": {
"message": "Protection",
"description": "The label for category 'Protection' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.solving-problems-adguard-for-android": {
"message": "Solving problems",
"description": "The label for category 'Solving problems' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.features-adguard-for-ios": {
"message": "Features",
"description": "The label for category 'Features' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.solving-problems-adguard-for-ios": {
"message": "Solving problems",
"description": "The label for category 'Solving problems' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.features-adguard-browser-extension": {
"message": "Features",
"description": "The label for category 'Features' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.solving-problems-adguard-browser-extension": {
"message": "Solving problems",
"description": "The label for category 'Solving problems' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.features-adguard-for-safari": {
"message": "Features",
"description": "The label for category 'Features' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.solving-problems-adguard-for-safari": {
"message": "Solving problems",
"description": "The label for category 'Solving problems' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.features-adguard-mini-for-mac": {
"message": "Features",
"description": "The label for category 'Features' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.settings-adguard-mini-for-mac": {
"message": "Settings",
"description": "The label for category 'Settings' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.solving-problems-adguard-mini-for-mac": {
"message": "Solving problems",
"description": "The label for category 'Solving problems' in sidebar 'tutorialSidebar'"
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -26,3 +26,9 @@ _Tracking protection_ features prevent websites from seeing the search query you
Browser extensions are limited to a specific browser and are subject to its technical restrictions. Therefore, they cannot offer all the tracking protection features available in full-fledged ad-blocking apps.

:::

:::caution

In AdGuard Browser Extension, the _Block WebRTC_ option works globally — it either blocks or allows WebRTC for all websites. It cannot be controlled on a per-site basis. Exception rules like `@@||example.com^$stealth=webrtc` have no effect in the browser extension because the `webrtc` option is not among the [supported `$stealth` modifier options](/general/ad-filtering/create-own-filters#stealth-modifier). If you need per-site WebRTC control, use the full-fledged AdGuard app for Windows, Mac, or Android.

:::
Original file line number Diff line number Diff line change
Expand Up @@ -20,18 +20,18 @@ If you want to support the implementation of a new feature or bugfix, you can vo

1. Enable debug logging:

`adguard-cli config set log_level debug`
`adguard-cli config set log_level debug`

2. Reproduce the problem and try to remember the exact time it occurred.

3. Wait a while, then export the logs:

`adguard-cli export-logs`
`adguard-cli export-logs`

The archived log file will be downloaded to the application folder by default, and the path to the logs will be written to the console.
The archived log file will be downloaded to the application folder by default, and the path to the logs will be written to the console.

4. Send the log file to [devteam@adguard.com](mailto:devteam@adguard.com). Specify the time of the error and attach a link to your GitHub issue or its number (it appears as #number next to the title). Alternatively, you can upload the log file to Google Drive and share it with [devteam@adguard.com](mailto:devteam@adguard.com). Attach the file link to your GitHub issue.

5. Switch the logging mode back to `info`:

`adguard-cli config set log_level info`
`adguard-cli config set log_level info`
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or

## Use SockFilter driver

Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later.
Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead.

If this option is disabled, AdGuard will switch to the older WFP driver instead.
SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing.

When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers:

- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering.
- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack.
- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory.

When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable.
Loading
Loading