// the find
lissy93/AdGuardian-Term
🛡️ Terminal-based, real-time traffic monitoring and statistics for your AdGuard Home instance
A Rust-based terminal dashboard that polls your AdGuard Home instance's API and renders real-time query/block stats, filter list performance, and top domains in a TUI. It's for self-hosters who already run AdGuard Home and want a lightweight always-on status view (SSH session, Raspberry Pi screen, etc.) instead of the web admin UI.
Distribution is taken seriously: prebuilt binaries, a crates.io package, Docker image, Scoop and AUR packages, plus a one-liner installer — this isn't a cargo-run-only side project. The dependency list is short and boring (reqwest, tokio, serde, chrono, ratatui) with no network calls besides the AdGuard instance itself, which keeps the attack surface small. CI actually does something: unit tests, clippy, security checks, cross-compiled release binaries, and generated rustdoc, all wired into GitHub Actions. The troubleshooting section documents real hardware quirks (missing braille font glyphs on DietPi, GL.iNet's --glinet auth override) that only show up from people actually running this on real routers, not synthetic testing.
AdGuard credentials are configured via plaintext env vars or CLI flags with no secrets-file or keyring option, so they end up in shell history or `ps` output on multi-user boxes. The browser/web mode's 'quick start' path depends on a third-party Docker image (sdjnmxd/adguardian-web) that the README itself flags as not officially maintained — if that image goes stale, you're back to wrapping ttyd yourself. It's pure polling against AdGuard's query log endpoint (default every 2s), so there's no backoff or push mechanism, and tightening the interval or query-log limit just means hammering your own AdGuard instance harder. There's no alerting or export path (webhook, Prometheus, etc.) — it's a live view only, so anything you want to track over time or get paged on needs a separate tool.