adguardteam/adguardmv3

This repository holds a prototype of the AdGuard browser extension, updated to work with Google Chrome's new extension system called Manifest V3. Google has been transitioning away from the older Manifest V2 framework, which forces ad blocker developers to rewrite their tools. This project was built to prove that ad blocking could still work under the new, stricter rules. At a high level, ad blockers traditionally intercept web requests in real time and check them against lists of known ad servers. The new Manifest V3 system limits this approach, so the extension had to adapt by using a "declarative" method. This means the extension gives Chrome a pre-processed list of blocking rules, and the browser itself handles the actual blocking. The project includes tools to download these filter lists and convert them into the new format Chrome requires. The primary users are people who want to block ads in Chrome and filter maintainers who curate the lists of rules that decide what gets blocked. For instance, a filter maintainer can load a custom version of the extension into Chrome, tweak a specific rule, and immediately see if it successfully blocks a test ad. The prototype is described as fully functional for everyday browsing, though the developers note that Manifest V3 introduces limitations that power users might notice. It is worth noting that this specific repository has been archived. The prototype was successful and has been replaced by a beta version available in the Chrome Web Store, which will eventually become the main AdGuard extension. The older Manifest V2 version will continue to be supported separately until Google fully phases it out.