Adguard-Leaderboard/adguard-leaderboard

AdGuard Home Leaderboard Dashboard

A Flask-based dashboard that pulls DNS query stats from AdGuard Home and displays clients as anime character tier cards.

Project Structure

adguard-dashboard/
├── dashboard.py          # Flask app and AdGuard API integration
├── dashboard.wsgi        # Apache mod_wsgi entry point
├── templates/
│   └── dashboard.html    # Frontend tier card UI
├── static/
│   └── characters/       # Anime character images (tier1_1.png, etc.)
├── .env                  # Credentials (not committed to repo)
└── README.md

Tiers

Tier	Label	Query Range	Character(s)
1	Innocent	0 - 500	Totoro
2	Rookie	501 - 2000	Zenitsu
3	Protagonist	2001 - 5000	Spike Spiegel
4	Hardened Fighter	5001 - 10000	Vegeta, Mikasa, Endeavor, Zoro, Inuyasha
5	Final Boss	10001+	Eren Yeager (Founding Titan)

Each tier randomly selects a character image on page load. Images are stored as tier{N}_{num}.png in static/characters/.

Setup

Prerequisites

• Python 3
• Apache with mod_wsgi
• AdGuard Home instance

Installation

sudo mkdir -p /opt/adguard-dashboard/templates
sudo mkdir -p /opt/adguard-dashboard/static/characters
sudo python3 -m venv /opt/adguard-dashboard/venv
sudo /opt/adguard-dashboard/venv/bin/pip install flask requests python-dotenv

Copy files:

sudo cp dashboard.py /opt/adguard-dashboard/
sudo cp dashboard.wsgi /opt/adguard-dashboard/
sudo cp templates/dashboard.html /opt/adguard-dashboard/templates/

Environment Variables

Create /opt/adguard-dashboard/.env:

ADGUARD_HOST=http://192.168.1.235:30004
ADGUARD_USER=your_username
ADGUARD_PASS=your_password

Lock down permissions:

sudo chown root:www-data /opt/adguard-dashboard/.env
sudo chmod 640 /opt/adguard-dashboard/.env

Apache Configuration

Add a config in /etc/apache2/sites-available/ pointing to dashboard.wsgi via mod_wsgi.

To reload after changes:

sudo touch /opt/adguard-dashboard/dashboard.wsgi

Adding Characters

Drop images into static/characters/ named tier{N}_{num}.png (e.g. tier3_2.png), then update the TIER_CHARS object in dashboard.html to include the new filename in the appropriate tier array.

const TIER_CHARS = {
    1: ['tier1_1.png', 'tier1_2.png'],
    ...
};