Skip to content

Medformatik/adguard_home_client

Repository files navigation

AdGuard Home Client

AdGuard Home Client

An Android remote for monitoring and controlling your AdGuard Home instances.

Latest release License

Get it on Google Play   Add to Obtainium

Features

  • Multi-instance support. Configure as many AdGuard Home instances as you like and switch between them with a tap on the AppBar title.
  • Unified view that aggregates stats, top-N tables, and the query log across every instance. Toggles control all instances at once when they agree, and show "Mixed" (disabled) when they don't.
  • Live statistics for DNS queries, blocked traffic, malware/phishing, parental control, and Safe Search — with 90-day trend charts and Top queried domains, Top blocked domains, and Top clients tables.
  • Query log with searchable, time-stamped entries, blocked/allowed indicators, human-readable reasons, and a details sheet. In Unified mode each entry is tagged with its source instance.
  • Protection toggles. One-tap on/off for the master Protection, plus Safe Browsing, Parental Control, and Safe Search.
  • HTTPS / TLS with an optional Verify TLS certificate toggle for self-signed certificates.
  • Material 3 UI with system-following dark mode, pull-to-refresh, and humanized numbers.

Install

Screenshots

Home screen with stats Top domains and clients

Setup

  1. Open the app and tap Add instance.
  2. Enter the AdGuard Home host (IPv4, IPv6, or domain), port (default 3000), username and password.
  3. Toggle Use HTTPS if your instance is reachable over TLS. For self-signed certificates, also disable Verify TLS certificate.
  4. Save. The home screen reconnects and starts streaming stats.
  5. Add more instances any time and switch between them via the AppBar title — or pick Unified to aggregate them all.

Build from source

git clone https://github.com/Medformatik/adguard_home_client.git
cd adguard_home_client
flutter pub get
flutter run

Build a release APK with:

flutter build apk --release

For signed builds you'll need an android/key.properties pointing at your keystore (see Flutter's signing guide). The repo's android/.gitignore excludes key.properties and *.jks so credentials never reach the repo.

⚠️ DISCLAIMER ⚠️

This is an unofficial app. The development of the AdGuard Home software is not related with this application in any way.

About

A control and monitoring app for AdGuard Home instances.

Topics

Resources

License

Stars

Watchers

Forks

Contributors