How AdGuard uses GitHub to stay transparent and user-oriented

At AdGuard, we fight daily to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community.

This is why all of our products have public repositories — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GutHub, and all AdGuard projects are stored there.

This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there.

💡
Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it.

What is Github and its repositories

Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly.

GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute.

A repository (often called “repo” for short) is the most basic element of GitHub. It's a place where you can store your code, your files, and each file's revision history. Repositories can have multiple collaborators and can be either public or private.

Where to start

You can find links to key repositories below in this article or visit the general AdGuardTeam GitHub page for a full list. In most repos, you can:

  • View README file on the main page: it gives you an introduction to the product and its repo
    README file *mobile_border

  • Check existing bug reports or feature requests, comment and upvote
    Check issues *mobile_border

  • Create issues to report bugs or request features
    Create issues *mobile_border

  • Check releases for different versions and their changelogs (and install an older version if needed)
    Check releases *mobile_border

  • Install any older or beta version if needed
    Download builds *mobile_border

Note: If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones.

In open-source repos advanced users can also:

  • Browse code to understand product logic, what technologies are used and how they are implemented
  • Fork and contribute via pull requests

Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos.

AdGuard Ad Blocker products

In these repositories users can:

  • View and report bugs or feature requests via GitHub issues
  • Check changelogs, track release history, monitor updates
  • Download latest, previous, and beta builds (except for iOS)

AdguardForAndroid

Repository of AdGuard for Android — an app that provides system-wide ad blocking.

AdguardForiOS

Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code.

AdguardForWindows

Repository of AdGuard for Windows app (non-open-source; GitHub used as an open bug tracker).

AdguardForMac

Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only.

AdguardBrowserExtension

Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge.

AdguardForSafari

Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code.

AdGuardCLI

Repository of AdGuard for Linux — a command‑line interface for managing ad blocking.

AdGuard VPN products

In these repositories users can:

  • View and report bugs or feature requests via GitHub issues
  • Check changelogs, track release history, monitor updates
  • Download latest, previous, and beta builds (except for iOS)

AdGuardVPNForiOS

Repository of AdGuard VPN for iOS app. Serves as an open bug tracker.

AdGuardVPNForAndroid

Repository of AdGuard VPN for Android app. Serves as an open bug tracker.

AdGuardVPNForWindows

Repository of AdGuard VPN for Windows app. Serves as an open bug tracker.

AdGuardVPNForMac

Repository of AdGuard VPN for Mac — app designed for macOS.

AdGuardVPNExtension

Repository of AdGuard VPN Browser Extension.

AdGuardVPNCLI

Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker.

DNS-based products

AdGuardDNS

Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can:

  • View and report DNS issues
  • Suggest improvements

AdGuardHome

Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can:

  • Check and file bug reports or feature requests
  • Review or contribute to code
  • Download and install releases

Documentation and Knowledge bases

Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can:

  • Suggest corrections or edits to knowledge base articles
  • Propose new articles
  • Test or run the local version

KnowledgeBase

Central documentation for AdGuard Ad Blocker and the technologies related to it.

KnowledgeBaseDNS

Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them.

KnowledgeBaseVPN

Detailed feature overview and troubleshooting guides for AdGuard VPN.

KnowledgeBaseMail

Detailed feature overview and troubleshooting guides of AdGuard Mail.

Core libraries

AdGuardCoreLibs

AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can:

  • Explore filtering logic and DNS handling
  • Report bugs and suggest features via Issues, contribute code via Pull requests

DNSLibs

A DNS library used by CoreLibs and AdGuardHome. Users can:

  • Review and contribute to low-level DNS implementation
  • Suggest optimizations

VPNLibs

Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can:

  • Contribute to VPN stack behavior
  • Report or view performance issues and bugs

Core ad blocking and filtering technologies

AdguardFilters

Contains AdGuard’s core filter lists. Users can:

  • View and download filter lists
  • Create issues to report false positives or suggest new rules
  • Monitor updates to filter logic

AdGuardSDNSFilter

Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can:

  • Inspect the current rule set
  • Propose changes or additions

AGLint

A linter for adblock filter list syntax. Users can:

  • Install AGLint to check their projects for rule issues
  • Contribute to lint rules

Scriptlets

JavaScript helpers used in filtering rules. Users can:

  • Explore available scriptlets
  • Submit pull requests for new scriptlets

tsurlfilter

TypeScript content blocker library for browser extensions. Users can:

  • Explore how filtering logic is implemented
  • Contribute fixes and features

There’s more

Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can find the rest on the AdGuardTeam GitHub page.

We’ll be waiting for your feedback there! Stay safe online and offline.

Liked this post?
19,611 19611 user reviews
Excellent!

AdGuard for Windows

AdGuard for Windows is more than an ad blocker. It is a multipurpose tool that blocks ads, controls access to dangerous sites, speeds up page loading, and protects children from inappropriate content.
By downloading the program you accept the terms of the License agreement
Read more
AdGuard for Windows v7.21, 14-day trial period
19,611 19611 user reviews
Excellent!

AdGuard for Mac

AdGuard for Mac is a unique ad blocker designed with macOS in mind. In addition to protecting you from annoying ads in browsers and apps, it shields you from tracking, phishing, and fraud.
By downloading the program you accept the terms of the License agreement
Read more
AdGuard for Mac v2.17, 14-day trial period
19,611 19611 user reviews
Excellent!

AdGuard for Android

AdGuard for Android is a perfect solution for Android devices. Unlike most other ad blockers, AdGuard doesn't require root access and provides a wide range of app management options.
By downloading the program you accept the terms of the License agreement
Read more
Scan to download
Use any QR-code reader available on your device
AdGuard for Android v4.11, 14-day trial period
19,611 19611 user reviews
Excellent!

AdGuard for iOS

The best iOS ad blocker for iPhone and iPad. AdGuard eliminates all kinds of ads in Safari, protects your privacy, and speeds up page loading. AdGuard for iOS ad-blocking technology ensures the highest quality filtering and allows you to use multiple filters at the same time
By downloading the program you accept the terms of the License agreement
Read more
Scan to download
Use any QR-code reader available on your device
AdGuard for iOS v4.5
19,611 19611 user reviews
Excellent!

AdGuard Content Blocker

AdGuard Content Blocker eliminates all kinds of ads in mobile browsers that support content-blocking technology — namely, Samsung Internet and Yandex Browser. Its features are limited compared to AdGuard for Android, but it is free, easy to install, and efficient
By downloading the program you accept the terms of the License agreement
Read more
AdGuard Content Blocker v2.8
19,611 19611 user reviews
Excellent!

AdGuard Browser Extension

AdGuard is the fastest and most lightweight ad blocking extension that effectively blocks all types of ads on all web pages! Choose AdGuard for the browser you use and get ad-free, fast and safe browsing.
AdGuard Browser Extension v5.1
19,611 19611 user reviews
Excellent!

AdGuard Assistant

A companion browser extension for AdGuard desktop apps. It offers an in-browser access to such features as custom element blocking, allowlisting a website or sending a report.
AdGuard Assistant v1.4
19,611 19611 user reviews
Excellent!

AdGuard Home

AdGuard Home is a network-based solution for blocking ads and trackers. Install it once on your router to cover all devices on your home network — no additional client software required. This is especially important for various IoT devices that often pose a threat to your privacy
AdGuard Home v0.107
19,611 19611 user reviews
Excellent!

AdGuard Pro for iOS

AdGuard Pro for iOS comes with all the advanced ad-blocking protection features enabled. It offers the same tools as the paid version of AdGuard for iOS. It excels at blocking ads in Safari and lets you customize DNS settings to tailor your protection. It blocks ads in browsers and apps, protects your kids from inappropriate content, and keeps your personal data safe
By downloading the program you accept the terms of the License agreement
Read more
AdGuard Pro for iOS v4.5
19,611 19611 user reviews
Excellent!

AdGuard for Safari

Ad blocking extensions for Safari are having hard time since Apple started to force everyone to use the new SDK. AdGuard extension is supposed to bring back the high quality ad blocking back to Safari.
AdGuard for Safari v1.11
19,611 19611 user reviews
Excellent!

AdGuard for Android TV

AdGuard for Android TV is the only app that blocks ads, guards your privacy, and acts as a firewall for your Smart TV. Get warnings about web threats, use secure DNS, and benefit from encrypted traffic. Relax and dive into your favorite shows with top-notch security and zero ads!
AdGuard for Android TV v4.11, 14-day trial period
19,611 19611 user reviews
Excellent!

AdGuard for Linux

AdGuard for Linux is the world’s first system-wide Linux ad blocker. Block ads and trackers at the device level, select from pre-installed filters, or add your own — all through the command-line interface
AdGuard for Linux v1.0
19,611 19611 user reviews
Excellent!

AdGuard Temp Mail

A free temporary email address generator that keeps you anonymous and protects your privacy. No spam in your main inbox!
19,611 19611 user reviews
Excellent!

AdGuard VPN

66 locations worldwide

Access to any content

Strong encryption

No-logging policy

Fastest connection

24/7 support

Try for free
By downloading the program you accept the terms of the License agreement
Read more
19,611 19611 user reviews
Excellent!

AdGuard DNS

AdGuard DNS is a foolproof way to block Internet ads that does not require installing any applications. It is easy to use, absolutely free, easily set up on any device, and provides you with minimal necessary functions to block ads, counters, malicious websites, and adult content.
19,611 19611 user reviews
Excellent!

AdGuard Mail

Protect your identity, avoid spam, and keep your inbox secure with our aliases and temporary email addresses. Enjoy our free email forwarding service and apps for all operating systems
19,611 19611 user reviews
Excellent!

AdGuard Wallet

A secure and private crypto wallet that gives you full control over your assets. Manage multiple wallets and discover thousands of cryptocurrencies to store, send, and swap
Downloading AdGuard To install AdGuard, click the file indicated by the arrow Select "Open" and click "OK", then wait for the file to be downloaded. In the opened window, drag the AdGuard icon to the "Applications" folder. Thank you for choosing AdGuard! Select "Open" and click "OK", then wait for the file to be downloaded. In the opened window, click "Install". Thank you for choosing AdGuard!
Install AdGuard on your mobile device