Updated section: "Stock filter lists" >>> "Important" and added section: "Stock filter lists" >>> "AdGuard filter lists in uBlock"

garry-ut99 2024-07-04 12:08:58 +00:00
parent f3b28234d1
commit d4a4d7d6c0

@ -82,7 +82,7 @@ Filter lists are automatically updated according to _expiration time_ defined by
Don't worry if you sometimes notice that some of your lists are marked "⚠️ Out of date" or some of them appear to update every time you open the dashboard. uBO updates filters lists in periodic sessions. In regular browser usage, the first one begins [`autoUpdateDelayAfterLaunch`](./Advanced-settings#autoupdatedelayafterlaunch) (105) seconds after uBO (your browser) is started. Lists found to be outdated (for which _expiration time_ passed) are then downloaded in [`autoUpdateAssetFetchPeriod`](./Advanced-settings#autoupdateassetfetchperiod) (15) seconds intervals. After this update session ends, uBO will wait [`autoUpdatePeriod`](./Advanced-settings#autoupdateperiod) (1) hour to start updating filters again. Update session will also be triggered by opening the dashboard, that's why you may notice it more often. As you see, there can be periods of time between update sessions, where your lists appear to be outdated, but it's normal update cycle. In irregular browser usage, when your lists expiration time is exceeded more than twice, uBO will trigger "emergency" update, which should give you all your lists updated in below one minute after start.
Note: As for AdGuard filter lists in uBlock Origin: AdGuard uses a different way to encode diff-expires, currently there is no code yet in uBO to deal with AdGuard's differential update approach, hence their filter lists in uBO lack _Diff-Expires_ directive, and have only _Diff-Path_, which means that differential updates for AdGuard lists work only in AdGuard, while in uBlock Origin they fallback to regular _Expires_ directive, which is set to 5 days currently in their fiter lists, related issue: https://github.com/uBlockOrigin/uBlock-issues/discussions/3282.
Note: As for AdGuard filter lists in uBlock Origin: AdGuard uses a different way to encode diff-expires, currently there is no code yet in uBO to deal with AdGuard's differential update approach, hence their filter lists in uBO lack _Diff-Expires_ directive, and have only _Diff-Path_, which means that differential updates for AdGuard lists work only in AdGuard, while in uBlock Origin they fallback to regular _Expires_ directive, which is set to 5 days currently in their fiter lists, related issue: [Filter list with "Diff-Path" but without "Diff-Expires:"](https://github.com/uBlockOrigin/uBlock-issues/discussions/3282).
***
@ -123,7 +123,20 @@ This is a collection of various filter lists, grouped by purpose. To use a speci
#### Important
The more filter lists are selected, the higher the likelihood of website breakage. The quality of the selected filter lists also affects the likelihood of website breakage. The _EasyList_-related filter lists are high-quality filter lists, as they are actively maintained.
The more filter lists are selected, the higher the likelihood of websites breakages and interferrences between filter lists. The quality of the selected filter lists also affects the likelihood of website breakage. The _EasyList_ and _AdGuard_ -related filter lists are high-quality filter lists, as they are actively maintained. Hence to avoid possible websites breakages and interferrences between different filter lists, some non-uBlock filter lists are unchecked by default and need to be manually enabled by users at their own risk, and breakages caused by such additional filters lists are to be reported to issue trackers of the lists, for example: https://github.com/easylist/easylist or https://github.com/AdguardTeam/AdguardFilters, because https://github.com/uBlockOrigin/uAssets tracker is mainly reserved for issues related to uBlock's stock filter lists.
#### AdGuard filter lists in uBlock
Given a fact that both uBlock and [AdGuard](https://adguard.com/en/adguard-browser-extension/overview.html), are similiar-purposed blockers and have high compatibility with each other, there are several [AdGuard's filter lists](https://adguard.com/kb/general/ad-filtering/adguard-filters/#adguard-filters) available in uBlock.
However keep in mind that some of them are slightly modified and adapted by AdGuard for better compatibility with uBlock, as a result, they might be stored separately from each other, for example `AdGuard Ads` (Base Filter) list used by AdGuard browser extensions is stored in:
[LINK for AdGuard](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_2_Base/filter.txt), while `AdGuard Ads` used in uBlock is stored in: [LINK for uBlock](https://filters.adtidy.org/extension/ublock/filters/2_without_easylist.txt).
Additionaly, `AdGuard Ads` (Base Filter) list in AdGuard is combined with EasyList, while in uBlock, `EasyList` and `AdGuard Ads` exist separately.
Also, 100% compatibility all the time between uBO and AG extensions, even when using the same filter list, is not guaranteed, because some filters might be just not 100% compatible, like it's not guaranteed that the same website will work/look 100% same in different browsers (for example: Firefox vs Chrome), related issue: [Same filters and diff extensions but diff results, why?](https://github.com/uBlockOrigin/uAssets/discussions/24340)
By the way, there is also ongoing discussion regarding supporting uBlock filter lists in AdGuard: [Add «uBlock Filters»](https://github.com/AdguardTeam/FiltersRegistry/issues/654).
***