Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
a227c56
Add a list of Windows apps with known compatibility issues
AlexandrPkhm Oct 21, 2025
3813115
Updated README.md and separated the app.txt into filtering and routin…
AlexandrPkhm Oct 21, 2025
f54a9bf
Updated README.md and separated the app.txt into filtering and routin…
AlexandrPkhm Oct 21, 2025
eb60a8d
Updated README.md with browsers.txt description. File extension is no…
AlexandrPkhm Oct 22, 2025
7ed3212
Remove upc.exe from routing_exclusions.json
AlexandrPkhm Oct 23, 2025
c1ff39c
Add the logioptionsplus.exe, logioptionsplus_updater.exe and nvcontai…
AlexandrPkhm Oct 28, 2025
171dd6a
Add the requested apps from https://github.com/AdguardTeam/AdguardFor…
AlexandrPkhm Oct 30, 2025
0d5e519
Add the requested app from https://github.com/AdguardTeam/AdguardForW…
AlexandrPkhm Nov 5, 2025
7fee128
Add the requested app from https://github.com/AdguardTeam/AdguardForW…
AlexandrPkhm Nov 10, 2025
f854635
Add the requested app from https://github.com/AdguardTeam/AdguardForW…
AlexandrPkhm Nov 10, 2025
89d521e
Add the requested app from https://github.com/AdguardTeam/AdguardForW…
AlexandrPkhm Nov 10, 2025
e67ce87
Add the requested app from https://github.com/AdguardTeam/AdguardForW…
AlexandrPkhm Dec 26, 2025
3463676
Add the requested app from https://github.com/AdguardTeam/AdguardForW…
AlexandrPkhm Dec 26, 2025
c7bb1f3
Add the requested app from https://github.com/AdguardTeam/AdguardForW…
AlexandrPkhm Dec 30, 2025
ef41454
add jsons
adbuker Feb 10, 2026
a94eddb
add browsers
adbuker Feb 10, 2026
5694a86
Apply suggestion from @Copilot
adbuker Feb 10, 2026
7bf44ae
Apply suggestion from @Copilot
adbuker Feb 10, 2026
7b1d35c
Apply suggestion from @Copilot
adbuker Feb 10, 2026
080c206
Update README.md
AlexandrPkhm Feb 10, 2026
1e6b124
Update windows/browsers.json
adbuker Feb 10, 2026
f71e4bd
reorder jsons
adbuker Feb 11, 2026
9868404
resolve comments
adbuker Feb 11, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 25 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Although we strive to maintain a high quality of filtering primarily through rul

## What AdGuard applications use these filtering lists?

Currently, they apply to AdGuard for Android.
Currently, they apply to AdGuard for Android and AdGuard for Windows.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

для макоси и клишных блокеров не актуально?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Пока нет, так как в них еще не реализован System wide filtering

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ну почему, актуально для макоси, про это задача есть


## How do these lists get updated in the AdGuard apps?

Expand Down Expand Up @@ -77,3 +77,27 @@ Here’s a simple steps to help you sort things out.
- [`ipv4_routes_exclusions_fujitsu.txt`](android/routes_exclusions/ipv4_routes_exclusions_fujitsu.txt) - A list of IPv4 ranges excluded from routing on problematic devices. This list applies on Fujitsu devices: F-01J, F-01K, F-01L, F-02H, F-03H, F-03K, F-04H, F-04K.

- [`ipv6_routes_exclusions.txt`](android/routes_exclusions/ipv6_routes_exclusions.txt) - A list of IPv6 ranges excluded from routing.

## Compatibility configuration for AdGuard for Windows

- [`http_filtering_exclusions_apps.json`](windows/http_filtering_exclusions_apps.json) - A list of app executables where traffic filtering is disabled (App Management -> Filter traffic).

- [`route_exclusions_apps.json`](windows/route_exclusions_apps.json) - A list of app executables where routing through AdGuard is disabled (App Management -> Route traffic through AdGuard).

- [`browsers.json`](windows/browsers.json) - A list of browsers where HTTPS traffic filtering is enabled by default (App Management -> Filter HTTPS traffic).

- [`https_filtering_apps.json`](windows/https_filtering_apps.json) - A list of non-browser apps where HTTPS traffic filtering is enabled by default (App Management -> Filter HTTPS traffic).

### Application model structure
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think it's a good idea to have identical structure for browsers.json and for different exclusions lists.

They have different purpose, and some fields only make sense in browsers and do not make any sense in other.

In browsers.json as far as I understand (@adbuker please correct me if I am wrong)

  • file_description - used for detecting processes to filter?
  • installed_conditions - only makes sense for browsers.json

At the same time, public_issue_url and private_issue_id only make sense in the files for exclusions.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

file_description - used for detecting processes to filter?

Btw, if this is true, I'd say it would be better to structure a browser record like this:

{
    "name": "Google Chrome",
    "routing_conditions": {
        "file_description": "Google Chrome",
        "executable_names": [
             "chrome.exe"
        ],
    },
    "installed_conditions": [
         // here go the installed conditions
    ]
}

In this case we'll only need routing_conditions in the exclusions files.


Each application entry in the JSON files uses the following structure:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is it not explained which files from above should use this structure


- `name` - Application or browser display name
- `file_description` - File description (optional, can be empty)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suggest renaming file_description to description. As far as I understand it is supposed to be a compatibility issue description right?

- `executable_names` - Array of executable file names associated with the application
- `installed_conditions` - Array of conditions to detect if the application is installed. Each condition has:
- `type` - Type of condition: `"RegistryKey"` or `"FilePath"`
- `pattern` - Registry key path or file path pattern (supports environment variables like `%LOCALAPPDATA%`, `%PROGRAMFILES%`, etc.)
- `public_issue_url` - Link to the public GitHub issue (optional)
- `private_issue_id` - Internal issue ID (optional)

Loading